Skip to content

Commit 1f48ac2

Browse files
[DDoS Protection] Missing fields + additional caveats (#22076)
* missing fields + additional caveats * fixes * Update src/content/docs/ddos-protection/managed-rulesets/http/override-expressions.mdx
1 parent 7cb95dc commit 1f48ac2

File tree

1 file changed

+23
-1
lines changed

1 file changed

+23
-1
lines changed

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

+23-1
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,8 @@ head:
88
content: Override expressions for HTTP DDoS Attack Protection
99
---
1010

11+
import { GlossaryTooltip } from "~/components"
12+
1113
:::note
1214

1315
Only available to Enterprise customers with the Advanced DDoS Protection subscription.
@@ -21,26 +23,46 @@ For example, you can set different sensitivity levels for different request URI
2123

2224
You can use the following fields in override expressions:
2325

26+
- `cf.bot_management.ja3_hash`
27+
- `cf.bot_management.ja4`
2428
- `cf.client.bot`
2529
- `cf.threat_score`
30+
- `cf.tls_cipher`
31+
- `cf.tls_client_auth.cert_verified`
32+
- `cf.tls_version`
33+
- `cf.verified_bot_category`
2634
- `http.cookie`
2735
- `http.host`
2836
- `http.referer`
37+
- `http.request.headers`
38+
- `http.request.headers.names`
39+
- `http.request.headers.truncated`
40+
- `http.request.headers.values`
2941
- `http.request.uri`
3042
- `http.request.uri.path`
43+
- `http.request.uri.path.extension`
3144
- `http.request.uri.query`
3245
- `http.request.full_uri`
3346
- `http.request.method`
3447
- `http.request.version`
3548
- `http.request.cookies`
3649
- `http.user_agent`
3750
- `http.x_forwarded_for`
51+
- `ip.geoip.asnum`
52+
- `ip.geoip.continent`
53+
- `ip.geoip.country`
54+
- `ip.geoip.is_in_european_union`
3855
- `ip.src`
3956
- `ip.src.asnum`
4057
- `ip.src.continent`
4158
- `ip.src.country`
4259
- `ip.src.is_in_european_union`
4360
- `ssl`
44-
- `cf.tls_client_auth.cert_verified`
4561

4662
Refer to the [Fields reference](/ruleset-engine/rules-language/fields/reference/) in the Rules language documentation for more information.
63+
64+
## Important remarks
65+
66+
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 which determines if the sensitivity level and action need to be adjusted.<br/>
67+
68+
For example, if you have an expression matching <GlossaryTooltip term="data packet">packets</GlossaryTooltip> with a specific source IP address and the override sets the sensitivity level to low, this override will only lower the sensitivity level for traffic that comes directly from that source IP address. If the DDoS protection system detects an attack coming from many source IP addresses targeted at a single destination IP and port, the generated fingerprint will only match the common criteria of the attack which, in this example, does not include the source IP address. The system will trigger the required mitigation actions at the default high sensitivity level because the traffic did not come from the user-provided source IP address. Therefore, traffic from the source IP in the override expression may still be blocked because the fingerprint only contains the destination IP address and port of the attack.

0 commit comments

Comments
 (0)