How rule groups differ
Custom rules are a tool that lets you flexibly configure protection for your needs. Four rule groups are available:
They complement one another and let you configure different aspects of protection.
Rule group comparison
| Rule group | What you can configure | Rule example | Can block traffic | When to use it |
|---|---|---|---|---|
Request frequency: the number of requests one IP address can send to a specified URI within a set time. If the number of requests reaches the limit, the system blocks it temporarily. |
A limit of 10 requests to |
Yes, when the limit is reached |
Protect endpoints from overload. Protect against business-logic abuse. |
|
The system response: what to do with a request that matches the rule conditions: pass it, block it, present a JavaScript challenge, present a cookie challenge, or present a CAPTCHA. |
When a request to
|
Yes, if you select the |
Set the protection system response for a specific scenario. |
|
An additional user check: for the specified traffic, the system presents an additional JavaScript challenge and calculates the user’s bot score. |
When a user sends a request to |
No* |
Increase filtering accuracy for specific scenarios. |
|
Filtering strictness: the bot score threshold for the specified traffic. This is the minimum bot score at which a request source is placed in the |
When a user accesses |
No* |
Set filtering strictness for different traffic types. |
|
Score collection and Bot classification do not block traffic directly, but they affect blocking indirectly. If a source’s bot score reaches or exceeds the threshold, the source is considered a bot. In Anti-bot mode, the system blocks bot requests by default.
|
||||
How rule groups work together
Suppose you have a /reports/generate page where users create complex reports. This operation requires significant computing resources. You want to protect against:
-
People who send an unusually large number of requests and may overload your system.
-
Bots that scrape information.
You configure the following rules:
-
Rate limits: 10 requests to
/reports/generatewithin 5 minutes from one IP address. When the limit is reached, block access for 5 minutes. -
Score collection: collect the bot score on the
/reports/generatepage. -
Bot classification: set the bot score threshold for
/reports/generateto0.4. -
Enforcement: when a request is sent to
/reports/generate, pass requests from people and present a CAPTCHA to bots.
When a request arrives at /reports/generate, protection works as follows:
-
It checks whether the IP address has previously sent requests to generate reports. If it has reached the limit of 10 requests within 5 minutes, the request source is blocked. Otherwise, the request proceeds to the next filtering stage.
-
It presents a JavaScript challenge. If the user cannot complete it, the system considers the user a bot. If the user completes it, the system calculates the user’s bot score.
If the user completed this challenge recently, the system has already calculated and stored the bot score. The user does not need to complete the challenge again. -
If the user’s bot score is between 0 and 0.3, the system marks the user as a human. If it is 0.4 or higher, the system marks the user as a bot.
-
It allows requests from people to reach your servers. Bots receive a CAPTCHA in response to their request.
-
If a user receives a CAPTCHA, the request is allowed only if the user completes the test successfully and the combined signals, including challenge-solving behaviour and client-environment data, indicate that a human completed the CAPTCHA.
Result: bots are blocked, and people can create reports freely as long as they do not send requests too often.
Where custom rules are located in the UI
Go to Application protection → Resources.
Find the resource for which you want to configure rules, click the ellipsis (…) at the end of the row, and select Custom rules.
In this section, select the tab for the required rule group.
| Some rule groups are enabled on request. If some tabs are inactive, contact support to enable them. |