Skip to content

[DDoS Protection] Missing fields + additional caveats #22076

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
merged 3 commits into from
Apr 29, 2025

Conversation

patriciasantaana
Copy link
Contributor

Summary

Missing fields and caveats for DDoS Protection's L7 HTTP override expressions

Documentation checklist

Copy link
Contributor

hyperlint-ai bot commented Apr 29, 2025

Howdy and thanks for contributing to our repo. The Cloudflare team reviews new, external PRs within two (2) weeks. If it's been two weeks or longer without any movement, please tag the PR Assignees in a comment.

We review internal PRs within 1 week. If it's something urgent or has been sitting without a comment, start a thread in the Developer Docs space internally.


PR Change Summary

Updated DDoS Protection documentation to include missing fields and additional important remarks regarding L7 HTTP override expressions.

  • Added missing fields for DDoS Protection's L7 HTTP override expressions.
  • Included important remarks about expression limitations and their implications.
  • Clarified the functionality of expressions in relation to DDoS mitigation actions.

Modified Files

  • src/content/docs/ddos-protection/managed-rulesets/http/override-expressions.mdx

How can I customize these reviews?

Check out the Hyperlint AI Reviewer docs for more information on how to customize the review.

If you just want to ignore it on this PR, you can add the hyperlint-ignore label to the PR. Future changes won't trigger a Hyperlint review.

Note specifically for link checks, we only check the first 30 links in a file and we cache the results for several hours (for instance, if you just added a page, you might experience this). Our recommendation is to add hyperlint-ignore to the PR to ignore the link check for this PR.

@patriciasantaana patriciasantaana marked this pull request as ready for review April 29, 2025 20:42
@patriciasantaana patriciasantaana requested a review from a team as a code owner April 29, 2025 20:42
Copy link
Contributor

@caley-b caley-b left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Only minor suggestions.


## Important remarks

- An expression is not an <GlossaryTooltip term="allowlist">allowlist</GlossaryTooltip> and does not become part of the attack fingerprint. The expression applies to the scope of the override and is used right before applying a mitigation action, to determine if the sensitivity level and action need to be adjusted.<br/>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It looks like a bullet point accidentally got in here.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oops! It totally did. Thanks for the catch!


## Important remarks

- An expression is not an <GlossaryTooltip term="allowlist">allowlist</GlossaryTooltip> and does not become part of the attack fingerprint. The expression applies to the scope of the override and is used right before applying a mitigation action, to determine if the sensitivity level and action need to be adjusted.<br/>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In the second sentence, I'd remove the comma or replace "to determine" with "which determines." Up to you!

@patriciasantaana patriciasantaana enabled auto-merge (squash) April 29, 2025 21:41
@patriciasantaana patriciasantaana merged commit 1f48ac2 into production Apr 29, 2025
13 checks passed
@patriciasantaana patriciasantaana deleted the patricia/pcx17119-l7-overrides branch April 29, 2025 21:53
- `http.request.uri.query`
- `http.request.full_uri`
- `http.request.method`
- `http.request.version`
- `http.request.cookies`
- `http.user_agent`
- `http.x_forwarded_for`
- `ip.geoip.asnum`
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Small nit @patriciasantaana :
Even though ip.geoip.* fields are still supported, we're recommending ip.src.* fields instead, so I think we could omit the first ones from this list. I've removed ip.geoip.* fields from all (most?) of our example expressions.

GregBrimble pushed a commit that referenced this pull request May 1, 2025
* missing fields + additional caveats

* fixes

* Update src/content/docs/ddos-protection/managed-rulesets/http/override-expressions.mdx
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants