Skip to content

Commit 8e3be69

Browse files
authored
[Email Security and Magic Firewall] Dashbutton-related updates (#24909)
* All updates support the dashbutton updates and/or small UI-related corrections in the docs found while making updates. * Added the component import.
1 parent 5df06fb commit 8e3be69

File tree

4 files changed

+55
-37
lines changed

4 files changed

+55
-37
lines changed

src/content/docs/cloudflare-one/email-security/email-monitoring/search-email.mdx

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -284,17 +284,17 @@ To open links in Security Center:
284284

285285
1. In [Zero Trust](https://one.dash.cloudflare.com/), go to **Email Security** > **Investigation**.
286286
2. Locate the message you want to open links for, select the three dots, then select **View details**.
287-
2. Under **Details**, go to **Links identified**.
287+
2. Under **Details**, go to **Links identified**.
288288
3. Locate the link you want to open, and select **Open in Security Center**.
289-
4. You will be redirected to **Investigate** under **Security Center**.
289+
4. You will be redirected to **Investigate** in the Cloudflare dashboard.
290290
5. Select **Scan now**.
291291
6. The dashboard will generate a report for your link.
292292

293293
To open links in Browser Isolation:
294294

295295
1. In [Zero Trust](https://one.dash.cloudflare.com/), go to **Email Security** > **Investigation**.
296296
2. Locate the message you want to open links for, select the three dots, then select **View details**.
297-
2. Under **Details**, go to **Links identified**.
297+
2. Under **Details**, go to **Links identified**.
298298
3. Locate the link you want to open, and select **Open in Browser Isolation**.
299299
4. The link will open in a separate window where you will be able to browse the content securely.
300300

@@ -304,12 +304,12 @@ To open and investigate a link in an external tool:
304304

305305
1. In [Zero Trust](https://one.dash.cloudflare.com/), go to **Email Security** > **Investigation**.
306306
2. Locate the message you want to open links for, select the three dots, then select **View details**.
307-
2. Under **Details**, go to **Links identified**.
307+
2. Under **Details**, go to **Links identified**.
308308
3. Locate the link you want to open, and select **Copy URL**.
309309
3. Paste the link in your external tool.
310310

311311
:::caution
312-
You may encounter a `400 Bad Request` error after turning **Clientless Web Isolation** on.
312+
You may encounter a `400 Bad Request` error after turning **Clientless Web Isolation** on.
313313

314314
If you encounter this error:
315315

src/content/docs/magic-firewall/how-to/add-rules.mdx

Lines changed: 15 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -6,17 +6,21 @@ sidebar:
66

77
---
88

9+
import { DashButton } from "~/components";
10+
911
You can check for an existing root ruleset from the dashboard or via the [Account rulesets API](/api/resources/rulesets/methods/list/). If you are a new Magic Transit customer, you may not have a root ruleset created for your account. To view examples for root rulesets, review the [Magic Firewall Terraform documentation](https://registry.terraform.io/providers/cloudflare/cloudflare/latest/docs/resources/magic_firewall_ruleset).
1012

1113
By default, you can create a maximum of 200 rules. We recommend you create lists of IP addresses to reference within rules to streamline rule management.
1214

1315
## Add a rule
1416

15-
1. Log in to your [Cloudflare dashboard](https://dash.cloudflare.com/login), and select your account.
16-
2. Select **Magic Firewall**.
17-
3. In the **Custom rules** tab, select **Add a Rule**.
18-
4. Fill out the information for your new rule. All existing rules apply to IPv4. You can use a managed [IP list](https://www.cloudflare.com/en-gb/ips/) when populating the **Value**.
19-
5. When you are done, select **Add new rule**.
17+
1. In the Cloudflare dashboard, go to the **Magic Firewall** page.
18+
19+
<DashButton url="/?to=/:account/network-security/magic_firewall" />
20+
21+
2. In the **Custom rules** tab, select **Add a Rule**.
22+
3. Fill out the information for your new rule. All existing rules apply to IPv4. You can use a managed [IP list](https://www.cloudflare.com/en-gb/ips/) when populating the **Value**.
23+
4. When you are done, select **Add new rule**.
2024

2125
## Create a disabled rule
2226

@@ -28,10 +32,12 @@ To disable an existing rule, from the **Magic Firewall Rules** page, set the **E
2832

2933
## Update a rule
3034

31-
1. Log in to your [Cloudflare dashboard](https://dash.cloudflare.com/login), and select your account.
32-
2. Select **Magic Firewall** > **Custom rules**.
33-
3. Locate the rule you want to edit, and select **Edit**.
34-
4. Update the rule with your changes and select **Edit rule**.
35+
1. In the Cloudflare dashboard, go to the **Magic Firewall** page.
36+
37+
<DashButton url="/?to=/:account/network-security/magic_firewall" />
38+
39+
2. In the **Custom rules** tab, locate the rule you want to edit and select the three dots > **Edit**.
40+
3. Update the rule with your changes and select **Save rule**.
3541

3642
## Delete an existing rule
3743

src/content/docs/magic-firewall/how-to/enable-managed-rulesets.mdx

Lines changed: 26 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,8 @@ pcx_content_type: how-to
44

55
---
66

7+
import { DashButton } from "~/components";
8+
79
With [managed rulesets](/ruleset-engine/managed-rulesets/), you can quickly deploy rules maintained by Cloudflare, and you can use Magic Firewall to control which rules are enabled.
810

911
:::note[Note:]
@@ -138,13 +140,15 @@ To delete a ruleset, refer to [Delete a rule in a ruleset](/ruleset-engine/rules
138140

139141
You can also use the dashboard to enable managed rulesets.
140142

141-
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login), and select your account.
142-
2. Go to **Magic Firewall** > **Managed rules**.
143-
3. Select **Deploy managed ruleset**.
144-
4. The page will refresh and show you rulesets configured by Cloudflare that are available to your account. Choose the ruleset you want with **Select ruleset**. If you do not see the ruleset you want, contact your account manager to get a list of all Magic Firewall Managed rulesets.
145-
5. Under **Ruleset configuration**, configure the **Ruleset action** from the drop-down menu. Cloudflare recommends you change this setting to **Log** to evaluate how the ruleset impacts your traffic before deciding on an action. For more information, refer to [Override a managed ruleset](/ruleset-engine/managed-rulesets/override-managed-ruleset/).
146-
6. Still under **Ruleset configuration**, choose *Enabled* from the dropdown-menu for the **Ruleset status**. This will apply an override to the default status of all the rules in the ruleset.
147-
7. Select **Deploy** to deploy the Magic Firewall Managed ruleset with no rule-level overrides.
143+
1. In the Cloudflare dashboard, go to the **Magic Firewall** page.
144+
145+
<DashButton url="/?to=/:account/network-security/magic_firewall" />
146+
147+
2. In the **Managed rules** tab, select **Deploy managed ruleset**.
148+
3. The page will refresh and show you rulesets configured by Cloudflare that are available to your account. Choose the ruleset you want with **Select ruleset**. If you do not see the ruleset you want, contact your account manager to get a list of all Magic Firewall Managed rulesets.
149+
4. Under **Ruleset configuration**, configure the **Ruleset action** from the drop-down menu. Cloudflare recommends you change this setting to **Log** to evaluate how the ruleset impacts your traffic before deciding on an action. For more information, refer to [Override a managed ruleset](/ruleset-engine/managed-rulesets/override-managed-ruleset/).
150+
5. Still under **Ruleset configuration**, choose *Enabled* from the dropdown-menu for the **Ruleset status**. This will apply an override to the default status of all the rules in the ruleset.
151+
6. Select **Deploy** to deploy the Magic Firewall Managed ruleset with no rule-level overrides.
148152

149153
### Add rule-level overrides
150154

@@ -154,21 +158,25 @@ On the other hand, if you did not apply Cloudflare’s recommendation in the pre
154158

155159
To add rule-level overrides in the dashboard:
156160

157-
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login), and select your account.
158-
2. Go to **Magic Firewall** > **Managed rules**.
159-
3. In front of **Magic Firewall Managed ruleset**, select **Manage**.
160-
4. Select **Browse rules**.
161-
5. In the rule you need to change, select an **Action** from the drop-down to change its action, or use the toggle to disable or enable the rule.
162-
6. Select **Next**.
163-
7. Select **Save**.
161+
1. In the Cloudflare dashboard, go to the **Magic Firewall** page.
162+
163+
<DashButton url="/?to=/:account/network-security/magic_firewall" />
164+
165+
2. In the **Managed rules** tab, locate the Magic Firewall managed ruleset you want to add rule-overrides to and select **Manage**.
166+
3. Select **Browse rules**.
167+
4. In the rule you need to change, select an **Action** from the drop-down to change its action, or use the toggle to disable or enable the rule.
168+
5. Select **Next**.
169+
6. Select **Save**.
164170

165171
The Cloudflare dashboard should now show you the rule-level override you have set.
166172

167173
### Delete Magic Firewall managed ruleset.
168174

169-
1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/login), and select your account.
170-
2. Go to **Magic Firewall** > **Managed rules**.
171-
3. Select **Manage**.
172-
4. Select **Delete deployment**.
175+
1. In the Cloudflare dashboard, go to the **Magic Firewall** page.
176+
177+
<DashButton url="/?to=/:account/network-security/magic_firewall" />
178+
179+
2. In the **Managed rules** tab, locate the Magic Firewall managed ruleset you want to delete and select **Manage**.
180+
3. Select **Delete deployment**.
173181

174182
Your Magic Firewall managed ruleset is now deleted.

src/content/docs/magic-firewall/tutorials/graphql-analytics.mdx

Lines changed: 9 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,8 @@ reviewed: 2022-03-02
1212
difficulty: Medium
1313
---
1414

15+
import { DashButton } from "~/components";
16+
1517
Use the GraphQL Analytics API to review data for Magic Firewall network traffic related to rules matching your traffic. This contains both rules you configured in the Magic Firewall dashboard, and the rules managed by Cloudflare as a part of [Magic Firewall Managed rules](/magic-firewall/how-to/enable-managed-rulesets/) and [Magic Firewall IDS](/magic-firewall/about/ids/) features.
1618

1719
Before you begin, you must have an [API token](/analytics/graphql-api/getting-started/authentication/). For additional help getting started with GraphQL Analytics, refer to [GraphQL Analytics API](/analytics/graphql-api/).
@@ -29,11 +31,13 @@ To construct a Magic Firewall GraphQL query for an object, you will need a Cloud
2931

3032
To construct queries to gather analytics for a particular rule, you need the rule ID for each firewall rule.
3133

32-
1. Log in to your [Cloudflare dashboard](https://dash.cloudflare.com/login), and select you account.
33-
2. Select **Magic Firewall**.
34-
3. Locate the rule you need the rule ID for from the list, and select **Edit**.
35-
4. Locate the **Rule ID**, and select the copy button.
36-
5. Select **Cancel** to return to the **Magic Firewall** page.
34+
1. In the Cloudflare dashboard, go to the **Magic Firewall** page.
35+
36+
<DashButton url="/?to=/:account/network-security/magic_firewall" />
37+
38+
2. In the **Custom rules** tab, locate the rule you need the rule ID for from the list and select the three dots > **Edit**.
39+
3. Locate the **Rule ID** and select the copy button.
40+
4. Select **Cancel** to return to the **Magic Firewall** page.
3741

3842
## Explore GraphQL schema with Magic Firewall query example
3943

0 commit comments

Comments
 (0)