← Документация WAF / tools

Lists

Списки позволяют группировать такие элементы, как IP-адреса, имена хостов или номера автономных систем (ASN), и ссылаться на них по имени в Cloudflare выражения правил. Вместо того чтобы добавлять каждый элемент отдельно в каждое правило, где он нужен, вы определяете группу один раз и затем используете её в разных правилах и зонах.

Можно создать собственный пользовательские списки или используйте Managed Lists поддерживаемых Cloudflare, например Managed IP Lists, которые предоставляют данные анализа угроз.

Списки обладают следующими преимуществами:

• При создании правила использовать список проще и менее подвержено ошибкам, чем добавлять длинный перечень элементов, например IP-адресов, прямо в выражение правила.
• При обновлении набора правил, нацеленных на одну и ту же группу IP-адресов (или имён хостов), использовать список IP-адресов (или список имён хостов) проще и менее подвержено ошибкам, чем редактировать несколько правил по отдельности.
• Списки легче читать, и они более информативны, особенно если вы используете для них описательные названия.

Когда вы обновляете содержимое списка, все правила, использующие этот список, обновляются автоматически, поэтому достаточно внести одно изменение в список, вместо того чтобы редактировать каждое правило по отдельности.

Cloudflare хранит ваши списки на уровне аккаунта. Один и тот же список можно использовать в правилах разных зон вашего аккаунта Cloudflare.

Cloudflare поддерживает следующие списки:

• Пользовательские списки: Включает пользовательские списки IP-адресов, списки имён хостов и списки ASN.
• Managed Lists: Списки, которыми управляет и которые обновляет Cloudflare, например Managed IP Lists.

Подробную информацию см. на соответствующей странице.

Также можно использовать встроенные списки в выражениях правил. Встроенные списки позволяют указывать значения прямо в выражении, не создавая отдельный список заранее. Однако для изменения значений придётся редактировать само правило.

Имя списка должно соответствовать следующим требованиям:

• В имени используются только строчные буквы, цифры и символ подчёркивания (_) в имени. Допустимое имя соответствует следующему регулярному выражению: ^[a-z0-9_]+$.
• Максимальная длина имени списка составляет 50 символов.

Вы можете создание списков в дашборде Cloudflare или с помощью Lists API.

После создания списка вы можете добавлять и удалять его элементы, но не можете изменить имя или тип списка.

Списки поддерживаются как в панели управления Cloudflare, так и в API Cloudflare:

• Чтобы использовать списки в выражении из панели управления Cloudflare, см. Использование списков в выражениях.
• Чтобы сослаться на список в выражении API, см. Lists в справочнике по языку Rules language.

Элементы списка можно найти в дашборде или через API.

Для списков IP-адресов Cloudflare возвращает IP-адреса или диапазоны, начинающиеся с вашего поискового запроса. Например, поиск 192.0.2 совпадает с 192.0.2.1 и 192.0.2.0/24, но при поиске 192.0.2.100 не соответствует Диапазон CIDR например 192.0.2.0/24 который содержит этот адрес.

Для Bulk Redirect Lists Cloudflare возвращает записи, у которых исходный или целевой URL содержит ваш поисковый запрос.

Доступность списков зависит от типа списка, а также от вашего тарифного плана и подписок Cloudflare.

Примечания:

• Количество доступных пользовательских списков зависит от самого высокого плана в вашем аккаунте. Любой аккаунт хотя бы с одним платным планом получает максимальную квоту.

• Клиенты с тарифным планом Enterprise могут создать не более 1,000 пользовательских списков суммарно по всем типам списков. Дополнительно действуют следующие ограничения:

  • До 40 списков имён хостов, но не более 10,000 элементов списка суммарно по всем спискам имён хостов.
  • До 40 списков ASN, но не более 30,000 элементов списка суммарно по всем спискам ASN.

• Клиенты с тарифным планом Enterprise, которым требуется больше пользовательских списков или более высокий предел количества элементов в списках, могут обратиться в свой account team.

• Сведения о доступности Bulk Redirect Lists см. в Правила документация.

Следующие роли пользователей имеют доступ к функциональности управления списками:

• Super Administrator
• Administrator
• Firewall

Список можно удалить только в том случае, если на него не ссылается ни одно правило (включённое или отключённое).

Cloudflare применяет следующие правила при добавлении элементов в существующий список (вручную или через файл CSV):

• Не удаляйте существующие элементы списка перед обновлением или добавлением элементов.
• Обновляет элементы, которые уже были в списке.
• Добавьте элементы, которых не было в списке.

Чтобы заменить всё содержимое списка сразу, оформите данные в виде массива и используйте Обновление всех элементов списка операцию в Lists API.

Дашборд Cloudflare не поддерживает скачивание списка в виде CSV файла. Чтобы экспортировать содержимое списка, используйте Получить элементы списка операция API.