-
Notifications
You must be signed in to change notification settings - Fork 10.4k
[WAF] Update dashboard instructions #20759
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
pedrosousa
merged 37 commits into
production
from
pedro/2025-03-12-waf-update-dashboard-instructions
Mar 12, 2025
Merged
Changes from 36 commits
Commits
Show all changes
37 commits
Select commit
Hold shift + click to select a range
7aa1c3a
Do not index the new section
pedrosousa e867d7b
Create overview page
pedrosousa f4e992b
Add tile icon
pedrosousa 974c038
Add pages for each dashboard section
pedrosousa fec58c0
Adjust target links for dashboard instructions
pedrosousa 32d7d97
Adjust target
pedrosousa abfb4fd
Link to specific dash step
pedrosousa 5fa32ad
Update Analytics page
pedrosousa 84bd466
Fix links and update intro
pedrosousa 8e4fdab
Add All Settings table
pedrosousa 7d80cdf
Update product meta title
pedrosousa 3df81e7
Small update to Security Overview
pedrosousa e1719b8
Fix link
pedrosousa f94b489
Add WAF detections section (for Settings)
pedrosousa 6ba34b2
Update link
pedrosousa 4adb5ba
Update column title in Settings
pedrosousa 7a23218
Update Security Rules page
pedrosousa e1b3c1b
Add initial dashboard steps (Security Rules)
pedrosousa a46e223
Add more sections to Settings
pedrosousa 4196050
Add step anchors to target pages
pedrosousa a662d27
Move "beta" from badge to tile name
pedrosousa 5ac6352
Update tile name
pedrosousa 3fb7ce1
Small fix
pedrosousa 731d04e
Make Settings a top-level entry
pedrosousa 4e2a4a0
Merge branch 'production' into pedro/2025-02-17-security-poc
pedrosousa bc16437
Update tile based on latest changes
pedrosousa 667adcd
Update capitalization of "Web asset discovery"
pedrosousa 5593188
WAF: Update Security Analytics shared UI labels
pedrosousa f75fa19
Security Analytics: Update UI label
pedrosousa 4b54d9e
Latest updates
pedrosousa 9225d31
Add "DDoS attacks module"
pedrosousa 9e9f6a5
More changes
pedrosousa 95689d0
Merge branch 'production' into pedro/2025-02-17-security-poc
pedrosousa e0f0990
Update UI label
pedrosousa 2994cd7
Update back Security Analytics UI labels
pedrosousa 8dfa078
Fix broken link
pedrosousa 15abfb8
PCX review
pedrosousa File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,58 @@ | ||
| --- | ||
| title: Security Analytics | ||
| pcx_content_type: concept | ||
| sidebar: | ||
| order: 3 | ||
| description: Security Analytics shows information about all incoming HTTP requests or mitigated requests (rule matches). | ||
| --- | ||
|
|
||
| import { GlossaryTooltip } from "~/components"; | ||
|
|
||
| Security Analytics shows information about all incoming HTTP requests or only about requests mitigated by Cloudflare. | ||
|
|
||
| Use Security Analytics as your starting point to understand and analyze traffic patterns, and to create security rules based on the filters you applied. | ||
|
|
||
| ## Traffic | ||
|
|
||
| The **Traffic** tab displays information about all incoming HTTP requests for your domain, including requests not handled by Cloudflare security products. | ||
|
|
||
| In this tab you can perform several tasks: | ||
|
|
||
| - View the traffic distribution for your domain. | ||
| - Understand which traffic is being mitigated by Cloudflare security products, and where non-mitigated traffic is being served from (Cloudflare global network or [origin server](https://www.cloudflare.com/learning/cdn/glossary/origin-server/)). | ||
| - Analyze suspicious traffic and create tailored custom [security rules](/security/rules/) based on applied filters. | ||
| - [Find an appropriate rate limit](/waf/rate-limiting-rules/find-rate-limit/) for incoming traffic. | ||
|
|
||
| For information on how to use the **Traffic** tab, refer to [Security Analytics](/waf/analytics/security-analytics/#adjusting-displayed-data). | ||
|
|
||
| If you need to modify existing security-related rules you already configured, consider also using the [Events](#events) tab. This tab displays information about requests affected by Cloudflare security products. | ||
|
|
||
| ### Suspicious activity | ||
|
|
||
| The suspicious activity gives you information about suspicious requests that were identified by the Cloudflare detections you have enabled. The supported detections include: | ||
|
|
||
| - [Account takeover](/bots/concepts/detection-ids/#account-takeover-detections) | ||
| - [Leaked credential check](/waf/detections/leaked-credentials/) (only for user and password leaked) | ||
| - [Malicious uploads](/waf/detections/malicious-uploads/) | ||
| - Firewall for AI | ||
| - [WAF attack score](/waf/detections/attack-score/) | ||
|
|
||
| Each suspicious activity is classified with a severity score that can vary from critical to low. You can use the filter option to investigate further. | ||
|
|
||
| :::note | ||
| The **Traffic** tab includes functionality available in the [Security Analytics](/waf/analytics/security-analytics/) page in the previous dashboard navigation structure. However, some page elements will appear in a different order, or they may be unavailable in the **Traffic** tab, such as Insights or the score-based analyses sidebar. | ||
| ::: | ||
|
|
||
| ## Events | ||
|
|
||
| Use the **Events** tab to review <GlossaryTooltip term="mitigated request">mitigated requests</GlossaryTooltip> and to tailor your security configurations. | ||
|
|
||
| The **Events** tab displays information about requests actioned or flagged by Cloudflare security products. Each incoming HTTP request might generate one or more security events. The tab only shows these events, not the HTTP requests themselves. To obtain information on all incoming HTTP requests, use the [Traffic](#traffic) tab. | ||
|
|
||
| Users on a Free plan can view summarized events by date in sampled logs. Customers on paid plans have access to additional graphs and dashboards that summarize the most relevant information about the current behavior of Cloudflare's security features on your zone. | ||
|
|
||
| For more information on the **Events** tab, refer to [Security Events](/waf/analytics/security-events/). | ||
|
|
||
| :::note | ||
| The **Events** tab corresponds to the [Security Events](/waf/analytics/security-events/) page in the previous dashboard navigation structure. | ||
| ::: |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,66 @@ | ||
| --- | ||
| title: Security dashboard (beta) | ||
| pcx_content_type: overview | ||
| sidebar: | ||
| order: 1 | ||
| description: The Security dashboard (beta) helps you understand the current security posture of your web applications and allows you configure different security rules for those applications. | ||
| head: | ||
| - tag: title | ||
| content: Overview | ||
| --- | ||
|
|
||
| import { Card, CardGrid, Feature, LinkTitleCard, RelatedProduct } from "~/components"; | ||
|
|
||
| The Security dashboard (beta) is your starting point to better understand the security posture of your web applications, and to configure rules to protect them. | ||
|
|
||
| <Card title="New dashboard experience" icon="rocket"> | ||
|
|
||
| The new **Security** navigation in the Cloudflare dashboard is currently available in beta for users that opt in to the new user interface. To opt in: | ||
|
|
||
| 1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com), and select your account and domain. | ||
| 2. Open any page under **Security**. | ||
| 3. In the top right-hand corner of the page, select **Try new security dashboard**. | ||
|
|
||
| You can swap back to the previous dashboard at any time by selecting **Return to old security dashboard** in the same page location. | ||
|
|
||
| </Card> | ||
|
|
||
| ## Features | ||
|
|
||
| <Feature header="Security overview" href="/security/overview/" cta="Explore Security overview"> | ||
| Get a high-level overview of your domain's security posture. | ||
| </Feature> | ||
|
|
||
| <Feature | ||
| header="Security Analytics" | ||
| href="/security/analytics/" | ||
| cta="Explore Security Analytics" | ||
| > | ||
| Shows information about all incoming HTTP requests or mitigated requests (rule | ||
| matches). Tailor your security configurations based on sampled logs. | ||
| </Feature> | ||
|
|
||
| <Feature header="Web asset discovery" href="/security/resources/"> | ||
| Discover your web assets (including API endpoints) and instruct Cloudflare how | ||
| to best protect them. | ||
| </Feature> | ||
|
|
||
| <Feature header="Security rules" href="/security/rules/"> | ||
| Perform security actions on incoming requests that match specified filters. | ||
| </Feature> | ||
|
|
||
| --- | ||
|
|
||
| ## More resources | ||
|
|
||
| <CardGrid> | ||
|
|
||
| <LinkTitleCard | ||
| title="Plans" | ||
| href="https://www.cloudflare.com/plans/#overview" | ||
| icon="document" | ||
| > | ||
| Compare available Cloudflare plans | ||
| </LinkTitleCard> | ||
|
|
||
| </CardGrid> |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,17 @@ | ||
| --- | ||
| title: Security overview | ||
| pcx_content_type: concept | ||
| sidebar: | ||
| order: 2 | ||
| --- | ||
|
|
||
| Security overview provides a high-level security overview of you zone. Security overview allows you to review the security posture of your domain. The security overview page is available on both the new security dashboard as well as the currently existing security dashboard. | ||
|
|
||
| The Security overview page will display the following information: | ||
|
|
||
| - **Traffic last 7 days**: Review traffic from the last seven days that has been mitigated, served by Cloudflare, and served by origin. | ||
| - **Security posture**: | ||
| - **Configurations**: Review your currently enabled configurations, and whether additional configurations are required for them. | ||
| - **Suggestions**: Review security suggestions to improve your security posture. | ||
| - **Rules with the most activity**: Review the number of times a security rule has been activated by matching requests. | ||
| - **Last updated rules**: Review rules you recently changed. | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,51 @@ | ||
| --- | ||
| title: Security rules | ||
| pcx_content_type: concept | ||
| sidebar: | ||
| order: 5 | ||
| description: Security rules perform security actions on incoming requests that match specified filters. | ||
| --- | ||
|
|
||
| Security rules perform security-related actions on incoming requests that match specified filters. Rules are evaluated and executed in order, from first to last. | ||
|
|
||
| ## Security rules | ||
|
|
||
| The **Security rules** tab includes a list of different types of rules configured in your zone to protect your applications and resources. | ||
|
|
||
| To create a security rule: | ||
|
|
||
| 1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/) and select your account and zone. | ||
| 2. Go to **Security** > **Security rules**. | ||
| 3. (Optional) Select **Templates**, and then select a template from the list. You can customize the default configuration of the template before deploying the new rule. Refer to the resources listed in the next step. | ||
| 4. Select **Create rule** > select the type of rule you want to create. Refer to the following resources about each rule type: | ||
| - [Custom rules](/waf/custom-rules/create-dashboard/#rule-form) | ||
| - [Rate limiting rules](/waf/rate-limiting-rules/create-zone-dashboard/#rule-form) | ||
| - [API sequence rules](/api-shield/security/sequence-mitigation/#rule-form) | ||
| - [API JWT validation rules](/api-shield/security/jwt-validation/#rule-form) (requires a [token configuration](/security/settings/#all-settings)) | ||
| - [Managed rules exceptions](/waf/managed-rules/waf-exceptions/define-dashboard/#2-define-basic-exception-parameters) | ||
| - [Content security rules](/page-shield/policies/create-dashboard/#rule-form) (previously known as Page Shield policies) | ||
|
|
||
| :::note[Notes] | ||
|
|
||
| The **Security rules** tab includes functionality available in different products in the previous dashboard navigation structure, such as the [WAF](/waf/), [API Shield](/api-shield/), and [Page Shield](/page-shield/). | ||
|
|
||
| The tab may show additional rule types if you have configured at least one of the following: | ||
|
|
||
| - [IP access rules](/waf/tools/ip-access-rules/) | ||
| - [User agent blocking rules](/waf/tools/user-agent-blocking/) | ||
| - [Zone lockdown rules](/waf/tools/zone-lockdown/) | ||
|
|
||
| ::: | ||
|
|
||
| ## DDoS protection | ||
|
|
||
| The **DDoS Protection** tab shows the multiple DDoS mitigation services provided by Cloudflare. You can create rules to override these mitigation tools. DDoS attack protection overrides are only available to Enterprise customers with the Advanced DDoS Protection subscription. | ||
|
|
||
| To learn more about DDoS protection overrides, refer to the following resources: | ||
|
|
||
| - [HTTP DDoS attack protection overrides](/ddos-protection/managed-rulesets/http/override-expressions/) | ||
| - [Network-layer DDoS attack protection overrides](/ddos-protection/managed-rulesets/network/override-expressions/) | ||
|
|
||
| :::note | ||
| You define overrides for the Network-layer DDoS attack protection managed ruleset at the account level in Account Home > **L3/4 DDoS** > **Network-layer DDoS Protection**. | ||
| ::: |
Oops, something went wrong.
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.