Parameters
Define overrides for the Network-layer DDoS Attack Protection managed ruleset to change the action applied to a given attack or modify the sensitivity level of the detection mechanism. You can define overrides in the Cloudflare dashboard or define overrides via Rulesets API.
The available parameters are the following:
- Action
- Sensitivity Level
API property name: "action".
The action performed for packets that match specific rules of Cloudflare's DDoS mitigation services. The available actions are:
-
Log
- API value:
"log". - Only available on Enterprise plans. Logs requests that match the expression of a rule detecting network layer DDoS attacks. Recommended for validating a rule before committing to a more severe action.
- API value:
-
Block
- API value:
"block". - Blocks IP packets that match the rule expression given the sensitivity levels.
- API value:
-
DDoS Dynamic
- API value: N/A (internal rule action that you cannot use in overrides).
- Performs a specific action according to a set of internal guidelines defined by Cloudflare. The executed action can be Block or an undisclosed mitigation action.
API property name: "sensitivity_level".
Defines how sensitive a rule is. Affects the thresholds used to determine if an attack should be mitigated. A higher sensitivity level means having a lower threshold, while a lower sensitivity level means having a higher threshold.
The available sensitivity levels are:
| UI value | API value |
|---|---|
| High | "default" |
| Medium | "medium" |
| Low | "low" |
| Essentially Off | "eoff" |
The default sensitivity level is High.
In most cases, when you select the Essentially Off sensitivity level the rule will not trigger for any of the selected actions, including Log. However, if the attack is extremely large, Cloudflare's protection systems will still trigger the rule's mitigation action to protect Cloudflare's network.
Essentially Off means that we have set an exceptionally low sensitivity level so in most cases traffic will not be mitigated for you. However, attack traffic will be mitigated at exceptional levels to ensure the safety and stability of the Cloudflare network.
Log means that requests will not be mitigated but only logged and shown on the dashboard. However, attack traffic will be mitigated at exceptional levels to ensure the safety and stability of the Cloudflare network.