White list
Learn how the white list works, where it is placed in the filtering hierarchy, and how to configure it.
|
The list can contain up to 60,000 IP addresses. |
What is a white list?
A white list is a tool that lets you disable filtering for traffic from specific IP addresses or subnets.
Example: with the setting below, protection allows all traffic from 192.0.2.20 to reach your resource without checks.
When to use it
Use a white list for addresses that access your resource from outside and must not be blocked under any circumstances. For example:
-
Payment gateways and critical external services.
-
Partner APIs and integrations.
-
Monitoring and availability-checking systems.
-
Other trusted sources.
Where it is placed in the filtering hierarchy
Protection filters each request in stages: first with one filtering mechanism, then with the second, third, and so on. The list below shows the full sequence of filtering mechanisms.
|
The set of mechanisms differs depending on the protection mode you purchased: Anti-bot or Anti-DDoS. |
-
Anti-bot
-
Anti-DDoS
If two filtering mechanisms conflict, the mechanism that runs first is applied. For example, the white list has higher priority than geo restrictions. This means that all requests from an IP address in the white list are allowed, even if the IP address belongs to a country for which you restricted access.
How to configure a white list
-
Go to
Application protection → Resources. Click the ellipsis (…) next to the required resource and selectSettings.
-
Go to the
White listtab and click+ Add IP address to white list.
-
In the window that opens, complete the fields:
-
IP addresses: one or more IP addresses and/or subnets, separated by commas. For example:192.0.2.20,198.51.100.0/24. -
Description (optional): any comment. We recommend stating why you added the address to the white list. For example:Payment gateway. -
Expiration date (optional): the date and time when the address is automatically removed from the list. To add an address permanently, leave the field empty.
-
-
Click
Add to white list.
The addresses appear in the list. Configuration is complete.
|
If an IP address is already in the white or black list, the system does not add it again. This helps prevent duplicates and conflicts between the lists. You see an error message that shows which addresses were not added and why. You can download the table from the message and compare it with the current settings.
|
Manage the white list
On the White list tab, you can view all trusted addresses. The table provides the following information:
-
The IP address.
-
The description.
-
The expiration date.
-
The creation date.
You can manage addresses directly from the list:
-
Edit: click the ellipsis (
…) at the end of the row and selectEdit. In the window that opens, you can change any setting. -
Delete: click the ellipsis (
…), selectDelete, and confirm the action.