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.

White list address example

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.

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

  1. Go to Application protection → Resources. Click the ellipsis (…) next to the required resource and select Settings.

    Open resource settings
  2. Go to the White list tab and click + Add IP address to white list.

    Add an IP address to the white list
  3. 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.

    Add an address to the white list
  4. Click Add to white list.

The addresses appear in the list. Configuration is complete.

White list example

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.

Import results

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.

Trusted address list

You can manage addresses directly from the list:

  • Edit: click the ellipsis (…) at the end of the row and select Edit. In the window that opens, you can change any setting.

  • Delete: click the ellipsis (…), select Delete, and confirm the action.

White list address actions