Белый список

Как работает белый список, какое место занимает в иерархии механизмов фильтрации и как его настроить.

  • Список вмещает максимум 60 000 IP-адресов.

  • Через один API-запрос можно добавить максимум 2000 IP-адресов (число таких запросов не ограничено).

Что это

Белый список — инструмент, с помощью которого можно отключить фильтрацию для трафика с определённых IP-адресов или подсетей.

Пример: при настройках ниже защита будет пропускать весь трафик с адреса 192.0.2.20 на ваш ресурс без проверок.

Пример адреса из белого списка

Когда пригодится

Белый список нужен для адресов, которые обращаются к вашему ресурсу извне и не должны блокироваться ни при каких условиях. Например:

  • платёжные шлюзы и критически важные внешние сервисы,

  • API партнёров и интеграции,

  • системы мониторинга и проверки доступности,

  • другие доверенные источники.

Какое место занимает в иерархии фильтрации

Защита фильтрует каждый запрос поэтапно: сначала с помощью одного механизма фильтрации, затем второго, третьего и так далее. В списке ниже вы увидите полную цепочку механизмов фильтрации.

В зависимости от того, какой режим защиты вы подключили (Антибот или Анти-DDoS), набор механизмов будет отличаться.

  • Антибот

  • Анти-DDoS

  1. Чёрный список.

  2. Белый список.

  3. Верифицированные боты.

  4. Обеление по URL или заголовку.

  5. Геоограничения.

  6. Пользовательские правила.

  7. Индивидуальные настройки защиты.

  1. Чёрный список.

  2. Белый список.

  3. Верифицированные боты.

  4. Обеление по URL или заголовку.

  5. Геоограничения.

  6. Лимиты запросов.

  7. Фильтрация в зависимости от наличия DDoS-атаки.

Если два механизма фильтрации конфликтуют, применяется тот, который сработал первым. Например, белый список стоит выше геоограничений. Это значит, что все запросы с IP из белого списка будут пропущены — даже если этот IP относится к стране, для которой вы ограничили доступ.

Как настроить

  1. Перейдите в раздел Защита приложений → Ресурсы. Напротив нужного ресурса нажмите на многоточие (…) и выберите Настройки.

    Переход к настройкам ресурса

  2. Перейдите на вкладку Белый список и нажмите + Добавить IP-адрес в белый список.

    Кнопка для добавления адреса в белый список

  3. В открывшемся окне заполните поля:

    • IP-адреса — один или несколько IP-адресов и/или подсетей через запятую. Пример: 192.0.2.20, 198.51.100.0/24.

    • Описание (опционально) — произвольный комментарий. Советуем вписать причину добавления адреса в белый список. Пример: Платёжный шлюз.

    • Срок действия (опционально) — дата и время, когда адрес будет автоматически удалён из списка. Если хотите добавить адрес бессрочно, оставьте поле пустым.

    Добавление адреса в белый список

  4. Нажмите Добавить в белый список.

Адреса появятся в списке. Настройка закончена!

Пример белого списка

Если какой-то IP уже есть в белом или чёрном списке, система не добавит его повторно. Это помогает избежать дублей и конфликтов между списками.

Вы увидите сообщение об ошибке: какие адреса не были добавлены и почему. Таблицу из сообщения можно скачать и сверить с текущими настройками.

Результаты импорта

Как управлять

На вкладке Белый список можно посмотреть список всех доверенных адресов. В таблице доступна следующая информация:

  • IP-адрес.

  • Описание.

  • Срок действия.

  • Дата создания.

Список доверенных адресов

Можно управлять адресами прямо из списка:

  • Редактирование: нажмите на многоточие (…) в конце строки и выберите Редактировать. В открывшемся окне вы сможете изменить любые параметры.

  • Удаление: нажмите на многоточие (…), выберите Удалить и подтвердите удаление.

Действия над адресом из белого списка