Rule Responses

DataDome provides five response types:

  • Whitelist
    When the AI rule or the custom rule response is set to "Whitelist", the traffic to which the rule applies is allowed on your endpoint.

  • Timeboxing
    By setting an AI or custom rule to "Timeboxing", you can fine-tune the responses applied to the traffic reaching your endpoints based on a specified time. This response enables you to select a time period (specific hours on specific days of the week) during which the traffic should be whitelisted, and select a Captcha or block response to the remaining traffic not matching the specified time period.
    "Timeboxing" can be applied to all good and commercial bot traffic and to custom rules.

  • Rate Limiting
    By setting an AI or custom rule to "Rate Limiting", you can fine-tune the responses applied to the traffic reaching your endpoints based on the number of requests received during a specified period of time. This response enables you to define a volume threshold (by providing the value of the number of requests during a time period of either one hour or one day) below which the traffic should be whitelisted, and select a Captcha or block response to the traffic that exceeds the volume threshold.
    Once the selected period ends (at the end of a full hour or a day), the traffic will get whitelisted until it reaches the specified number of requests again and the Captcha or block Response is applied.
    "Rate Limiting" can be applied to all good and commercial bot traffic and to custom rules.

  • Captcha
    When the AI rule or the custom rule response is set to "Captcha", the Captcha is displayed to the traffic to which the rule applies.

  • Block
    When the AI rule or the custom rule response is set to "Block", the traffic to which the rule applies is completely blocked from accessing your endpoint. The Block rule should be applied to protect from any malicious human generated traffic that would otherwise be able to bypass the Captcha.

How to change the rule response?

There are 2 different methods to update the rule response:

  1. Head to "AI Detection" and go into the relevant bot family page, then find the rule you want to update and click the response selector to choose the response you wish to apply.

OR

  1. Head to "Responses" and search for the rule name in the "All" sub-page and click the response selector to choose the response you wish to apply.