Skip to content

Commit 96915ae

Browse files
authored
Implementing DashButton (#25034)
* Registrar - dash buttons * Cloudflare for Platforms - dash button * Added missing import * Removed incorrect dash button reference * Added missing dash buttons * Styling fixes
1 parent d58a7ab commit 96915ae

File tree

12 files changed

+164
-104
lines changed

12 files changed

+164
-104
lines changed

src/content/docs/cloudflare-for-platforms/cloudflare-for-saas/security/waf-for-saas/index.mdx

Lines changed: 37 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ sidebar:
66
label: Setup
77
---
88

9-
import { APIRequest } from "~/components";
9+
import { DashButton, APIRequest, } from "~/components";
1010

1111
[Web Application Firewall (WAF)](/waf/) allows you to create additional security measures through Cloudflare. As a SaaS provider, you can link custom rules, rate limiting rules, and managed rules to your custom hostnames. This provides more control to keep your domains safe from malicious traffic.
1212

@@ -68,34 +68,42 @@ This assigns custom metadata to your custom hostname so that it has a security t
6868

6969
1. Locate the custom metadata field in the Ruleset Engine where the WAF runs. This can be used to trigger different configurations of products such as [WAF custom rules](/waf/custom-rules/), [rate limiting rules](/waf/rate-limiting-rules/), and [Transform Rules](/rules/transform/).
7070

71-
2. Build your rules either through the dashboard or via the API.
72-
73-
To build rules through the dashboard, follow the instructions specific to [custom rules](/waf/custom-rules/create-dashboard/), [rate limiting rules](/waf/rate-limiting-rules/create-zone-dashboard/), or [managed rules](/waf/managed-rules/deploy-zone-dashboard/), depending on your security goal.
74-
75-
An example rate limiting rule, corresponding to `"security_level"` low, is shown below as an API call.
76-
77-
<APIRequest
78-
path="/zones/{zone_id}/rulesets/phases/{ruleset_phase}/entrypoint"
79-
method="PUT"
80-
json={{
81-
rules: [
82-
{
83-
action: "block",
84-
ratelimit: {
85-
characteristics: ["cf.colo.id", "ip.src"],
86-
period: 10,
87-
requests_per_period: 2,
88-
mitigation_timeout: 60,
89-
},
90-
expression:
91-
'lookup_json_string(cf.hostname.metadata, "security_level") eq "low" and http.request.uri contains "login"',
92-
},
93-
],
94-
}}
95-
parameters={{
96-
ruleset_phase: "http_ratelimit",
97-
}}
98-
/>
71+
2. Build your rules either [through the dashboard](/waf/custom-rules/create-dashboard/) or via the API. An example rate limiting rule, corresponding to `"security_level"` low, is shown below as an API call.
72+
73+
<APIRequest
74+
path="/zones/{zone_id}/rulesets/phases/{ruleset_phase}/entrypoint"
75+
method="PUT"
76+
json={{
77+
"rules": [
78+
{
79+
"action": "block",
80+
"ratelimit": {
81+
"characteristics": [
82+
"cf.colo.id",
83+
"ip.src"
84+
],
85+
"period": 10,
86+
"requests_per_period": 2,
87+
"mitigation_timeout": 60
88+
},
89+
"expression": "lookup_json_string(cf.hostname.metadata, \"security_level\") eq \"low\" and http.request.uri contains \"login\""
90+
}
91+
]
92+
}}
93+
parameters={{
94+
ruleset_phase: "http_ratelimit"
95+
}}
96+
/>
97+
98+
To build rules through the dashboard:
99+
100+
1. In the Cloudflare dashboard, go to the **WAF** page.
101+
102+
<DashButton url="/?to=/:account/application-security/waf" />
103+
104+
2. Follow the instructions on the dashboard specific to custom rules, rate limiting rules, or managed rules, depending on your security goal.
105+
106+
3. Once the rule is active, you should see it under the applicable tab (custom rules, rate limiting, or managed rules).
99107

100108
:::caution
101109
This API call will replace any existing rate limiting rules in the zone.

src/content/docs/cloudflare-for-platforms/workers-for-platforms/get-started/configuration.mdx

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,15 +5,18 @@ sidebar:
55
order: 1
66
---
77

8-
import { Render, PackageManagers, WranglerConfig } from "~/components";
8+
import { DashButton, Render, PackageManagers, WranglerConfig } from "~/components";
99

1010
## Prerequisites:
1111

1212
### Enable Workers for Platforms
1313

1414
To enable Workers for Platforms, you will need to purchase the [Workers for Platforms Paid plan](/cloudflare-for-platforms/workers-for-platforms/platform/pricing/).
1515

16-
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/?to=/:account/workers-for-platforms), and select your account.
16+
1. In the Cloudflare dashboard, go to the **Workers for Platforms** page and select your account.
17+
18+
<DashButton url="/?to=/:account/workers-for-platforms" />
19+
1720
2. Complete the payment process for the Workers for Platforms Paid plan.
1821

1922
If you are an Enterprise customer, contact your Cloudflare account team to enable Workers for Platforms.

src/content/docs/registrar/account-options/domain-contact-updates.mdx

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,8 @@ title: Registrant contact updates
44

55
---
66

7+
import { DashButton } from "~/components";
8+
79
It is important that you keep your contact details accurate and up-to-date. [ICANN rules state](https://www.icann.org/resources/pages/registrant-contact-information-wdrp-2017-08-31-en) that if you do not have updated contact information, your domain name registration may be suspended or even cancelled.
810

911
The contact information you can update includes:
@@ -17,12 +19,14 @@ The contact information you can update includes:
1719

1820
To update your registrant contacts:
1921

20-
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login), and select your account.
21-
2. Select **Domain Registration** > **Manage domains**.
22-
3. Find **Default contact** and select **Edit**.
23-
4. Update the relevant information, and select **Save**.
24-
5. Find the domain where you want to update your contact information, and select **Manage**.
25-
6. Select the **Contacts** tab, and edit the contact information.
22+
1. In the Cloudflare dashboard, go to the **Manage domains** page.
23+
24+
<DashButton url="/?to=/:account/registrar/domains" />
25+
26+
2. Find **Default contact** and select **Edit**.
27+
3. Update the relevant information, and select **Save**.
28+
4. Find the domain where you want to update your contact information, and select **Manage**.
29+
5. Select the **Contacts** tab, and edit the contact information.
2630

2731
If you change any of the following fields, Cloudflare Registrar will require a Change of Registrant approval before the changes are finalized:
2832

src/content/docs/registrar/account-options/domain-management.mdx

Lines changed: 24 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -4,32 +4,40 @@ title: Domain management
44

55
---
66

7-
import { LinkButton } from "~/components"
7+
import { DashButton, LinkButton } from "~/components"
88

99
## Domain status
1010

1111
When your domain is registered with Cloudflare, you can review your domain status in **Overview**.
1212

13-
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login), and select your account and domain.
14-
2. From **Overview**, scroll down to **Domain Registration** to review the current expiration date. Select **Manage domain** to review the Auto-Renew status for your domain.
13+
1. In the Cloudflare dashboard, go to the **Manage domains** page.
14+
15+
<DashButton url="/?to=/:account/registrar/domains" />
16+
17+
2. From **Overview**, scroll down to **Domain Registration** to review the current expiration date.
18+
3. Select **Manage domain** to review the Auto-Renew status for your domain.
1519

1620
## Billing information
1721

1822
Domain registrations will not appear in the **Active Subscriptions** section of the dashboard, as Registrar is not subscription based. To check information related to your domain billing:
1923

20-
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login), and select your account.
21-
2. Select **Domain Registration** > **Manage Domains**.
22-
3. Find the domain you want to check and select **Manage**.
23-
4. Refer to **Registration** for information regarding your domain fees. From here, you can also opt to [renew or extend](/registrar/account-options/renew-domains/) your domain registration.
24+
1. In the Cloudflare dashboard, go to the **Manage Domains** page.
25+
26+
<DashButton url="/?to=/:account/registrar/domains" />
27+
28+
2. Find the domain you want to check and select **Manage**.
29+
3. Refer to **Registration** for information regarding your domain fees. From here, you can also opt to [renew or extend](/registrar/account-options/renew-domains/) your domain registration.
2430

2531
## Edit WHOIS records
2632

2733
Cloudflare redacts WHOIS information from your domain by default. However, we do store the authentic WHOIS record for your domain. You may edit the WHOIS contact data for any domain. To do that:
2834

29-
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login), and select your account.
30-
2. Select **Domain Registration** > **Manage Domains**.
31-
3. Find the domain you want to edit and select **Manage** > **Contacts**.
32-
4. Select **Edit** in any of the contacts you previously set up. This allows you to update the contact information for the selected domain only. It will not update the contact information for other domains within the account.
35+
1. In the Cloudflare dashboard, go to the **Manage Domains** page.
36+
37+
<DashButton url="/?to=/:account/registrar/domains" />
38+
39+
2. Find the domain you want to edit and select **Manage** > **Contacts**.
40+
3. Select **Edit** in any of the contacts you previously set up. This allows you to update the contact information for the selected domain only. It will not update the contact information for other domains within the account.
3341

3442
Refer to [Registrant contact updates](/registrar/account-options/domain-contact-updates/) for more information.
3543

@@ -50,9 +58,11 @@ Deleting a domain registration from Cloudflare Registrar starts an irreversible
5058

5159
There may be instances where users may wish to delete a domain prior to expiration. In most cases a domain may be deleted prior to expiration by following these steps:
5260

53-
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login), and select your account and domain.
54-
2. From **Overview**, scroll down to **Domain Registration** and click **Manage domain**. <LinkButton variant="primary" href="https://dash.cloudflare.com/?to=/:account/domains">Go to <strong>Manage domain</strong></LinkButton>
55-
3. Under the **configuration** tab on the Manage page you will find a **Delete** button
61+
1. In the Cloudflare dashboard, go to the **Manage Domains** page.
62+
63+
<DashButton url="/?to=/:account/registrar/domains" />
64+
65+
3. Under the **Configuration** tab on the Manage page you will find a **Delete** button.
5666
4. If the domain is deletable the button will be active. The button will be disabled if your domain cannot be deleted and you should refer to the Registrar [FAQ](/registrar/faq/#why-am-i-unable-to-delete-my-registrar-domain).
5767
5. Once you click the Delete button, you will be presented with a confirmation window. If you proceed, an email will be sent to all users with the Super Admin role in the account. The email contains a deletion authorization token that must be entered into the window which appears to confirm and complete the deletion.
5868

src/content/docs/registrar/account-options/icloud-domains.mdx

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,9 @@ title: iCloud Custom Email Domains
55

66
---
77

8-
With [iCloud Custom Email Domain](https://support.apple.com/kb/HT212514), you can now purchase a custom domain right from iCloud Settings through Cloudflare and have it automatically set up with your iCloud Mail account. It’s great if you want to create a custom email domain for you or your family, such as @examplefamily.com.
8+
import { DashButton } from "~/components";
9+
10+
With [iCloud Custom Email Domain](https://support.apple.com/kb/HT212514), you can now purchase a custom domain right from iCloud Settings through Cloudflare and have it automatically set up with your iCloud Mail account. It's great if you want to create a custom email domain for you or your family, such as @examplefamily.com.
911

1012
You will need an active iCloud+ subscription to add a custom email domain.
1113

@@ -69,7 +71,7 @@ If your domain has records similar to those listed above and you are still exper
6971

7072
If you try to visit your new domain, your browser will show an error or empty page.
7173

72-
Thats because theres more to setting up a website than purchasing a domain name (which you just did) and setting up email records (which we just did for you). 
74+
That's because there's more to setting up a website than purchasing a domain name (which you just did) and setting up email records (which we just did for you). 
7375

7476
If you want your domain to be a fully functioning website, you will need to:
7577

@@ -86,8 +88,10 @@ After you buy a domain through iCloud, Cloudflare Registrar automatically enable
8688

8789
If you do not want to have Landing Page enabled:
8890

89-
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login) and select your account.
90-
2. Select **Registrar** > **Manage domains**.
91+
1. In the Cloudflare dashboard, go to the **Manage domains** page.
92+
93+
<DashButton url="/?to=/:account/registrar/domains" />
94+
9195
3. Find the domain you want to disable Landing Page for, and select **Manage** > **Configuration**.
9296
4. Scroll to Landing Page and select **Disable**.
9397

src/content/docs/registrar/account-options/renew-domains.mdx

Lines changed: 15 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,8 @@ head:
77

88
---
99

10+
import { DashButton } from "~/components";
11+
1012
## Automatic renewal of domain
1113

1214
Cloudflare Registrar enrolls your domain to auto-renew by default. Unlike other registrars, your domain will only renew at the list price set by the registry. When a domain has the auto-renew setting turned on, Cloudflare will attempt to automatically renew the domain prior to expiration.
@@ -29,9 +31,11 @@ You can continue to keep your domain registered with Cloudflare for the time rem
2931

3032
If you want your domains to renew automatically, keep the default settings for your domain (**Auto Renew** should be set to **On**). To find this setting:
3133

32-
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login) and select your account.
33-
2. Select **Domain Registration** > **Manage Domains**.
34-
3. Find the domain you want to automatically renew, and make sure the **Auto-renew** toggle is enabled.
34+
1. In the Cloudflare dashboard, go to the **Manage domains** page.
35+
36+
<DashButton url="/?to=/:account/registrar/domains" />
37+
38+
2. Find the domain you want to automatically renew, and make sure the **Auto-renew** toggle is enabled.
3539

3640
Cloudflare attempts to renew these domains automatically 30 days before their expiration date. Several more attempts are made if the first attempt fails. The last attempt to renew is made on the day before expiration. You can also [manually renew](#renew-a-domain-manually) a domain at any time.
3741

@@ -51,12 +55,14 @@ If you want to delete your domain from Cloudflare, **disable** Auto-Renew first.
5155

5256
You can renew a domain at any time. To renew a domain registered with Cloudflare:
5357

54-
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login) and select your account.
55-
2. Select **Domain Registration** > **Manage Domains**.
56-
3. Find the domain you want to renew and select **Manage**.
57-
4. In **Registration** select **Renew/Extend Domain**.
58-
5. In the **Renew for** drop-down menu, choose a number of years to renew your domain (up to 10 years).
59-
6. Select **Renew** and then **Purchase**.
58+
1. In the Cloudflare dashboard, go to the **Manage domains** page.
59+
60+
<DashButton url="/?to=/:account/registrar/domains" />
61+
62+
2. Find the domain you want to renew and select **Manage**.
63+
3. In **Registration** select **Renew/Extend Domain**.
64+
4. In the **Renew for** drop-down menu, choose a number of years to renew your domain (up to 10 years).
65+
5. Select **Renew** and then **Purchase**.
6066

6167
Once Cloudflare validates your payment, the status of your domain changes to **Renewal Pending**. After the renewal is finished, the status changes back to **Active**.
6268

src/content/docs/registrar/account-options/transfer-out-from-cloudflare.mdx

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,8 @@ head:
77

88
---
99

10+
import { DashButton } from "~/components";
11+
1012
Cloudflare Registrar makes it easy to transfer your domain to another registrar. Be aware that ICANN rules prohibit a domain from being transferred if:
1113

1214
* The domain has been transferred within the last 60 days;
@@ -22,12 +24,14 @@ Anyone with super-admin and admin permissions for a zone can also manage your do
2224

2325
## 1. Unlock your domain at Cloudflare
2426

25-
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login) and select your account.
26-
2. Go to **Domain Registration** > **Manage Domains**.
27-
3. Find the domain you want to transfer, and select **Manage**.
28-
4. Select **Configuration** > **Unlock**.
29-
5. Select **Confirm and Unlock** to confirm that you want to unlock your domain.
30-
6. Copy the auth code (also referred to as authentication code and authorization code) generated by Cloudflare, and use at your new registrar.
27+
1. In the Cloudflare dashboard, go to the **Manage Domains** page.
28+
29+
<DashButton url="/?to=/:account/registrar/domains" />
30+
31+
2. Find the domain you want to transfer, and select **Manage**.
32+
3. Select **Configuration** > **Unlock**.
33+
4. Select **Confirm and Unlock** to confirm that you want to unlock your domain.
34+
5. Copy the auth code (also referred to as authentication code and authorization code) generated by Cloudflare, and use at your new registrar.
3135

3236
If you lose your authentication code, you can get a new one by:
3337

0 commit comments

Comments
 (0)