← Документация WAF / tools / lists
Пользовательские списки
Пользовательский список содержит один или несколько элементов одного типа (например, IP-адреса, имена хостов или ASN), на которые можно ссылаться по имени в выражениях правил.
Cloudflare поддерживает следующие типы пользовательских списков:
- Списки с IP-адресами (также известные как списки IP-адресов)
- Списки с именами хостов
- Списки с ASN (автономная система ↗ номеров)
У каждого типа есть свои свойства и формат CSV-файла. Подробнее см. в следующих разделах.
Дополнительную информацию о списках, которыми управляет Cloudflare, например Managed IP Lists, см. в Managed Lists.
Создание пользовательского списка
См. Создание списка в панели управления или к Lists API страницу.
Использование пользовательского списка
Использование пользовательских списков в правиле выражения на in оператор и поле, поддерживаемое пользовательским списком:
<FIELD> in $<LIST_NAME>Поля, которые можно использовать, зависят от типа элемента списка:
| Тип элемента списка | Доступные поля |
|---|---|
| IP-адрес | Поля с типом IP address перечисленных в Справочник полей |
| Имя хоста | http.host |
| ASN | ip.src.asnum |
Дополнительную информацию и примеры см. в Использование списков в выражениях.
Типы пользовательских списков
Списки с IP-адресами (списки IP-адресов)
Элементы в пользовательских списках IP-адресов должны быть в одном из следующих форматов:
- Отдельные IPv4-адреса
- Отдельные IPv6-адреса
- Диапазоны IPv4 CIDR с префиксом от
/8к/32 - Диапазоны IPv6 CIDR с префиксом от
/12к/128
Один и тот же список может содержать как отдельные адреса, так и диапазоны CIDR.
Для адресов IPv6 в списках можно использовать символы верхнего или нижнего регистра. Однако при сохранении списка символы верхнего регистра преобразуются в нижний.
Формат файла CSV
При загрузке элементов в пользовательский список с IP-адресами через файл CSV используйте следующий формат файла (указывайте по одному элементу на строку):
<IP_ADDRESS_1>,<DESCRIPTION>
<IP_ADDRESS_2> <DESCRIPTION> поле необязательно.
Списки с именами хостов
Элементы в пользовательских списках имён хостов должны быть полностью квалифицированными доменными именами (FQDN). Элемент может содержать * префикс/подстановочный знак поддомена, после которого должен следовать . (точка). Элемент не может включать схему (например, https://) или путь URL.
Например, для пользовательского списка с именами хостов допустимы следующие записи:
example.comapi.example.com*.example.com
Однако, example.com/path/subfolder не будет допустимым значением.
В пользовательский список с именами хостов можно добавить любое допустимое имя хоста (действительное FQDN). Эти имена хостов не обязательно должны принадлежать текущему аккаунту Cloudflare.
Формат файла CSV
При загрузке элементов в пользовательский список с именами хостов через файл CSV используйте следующий формат файла:
<HOSTNAME_1>,<DESCRIPTION>
<HOSTNAME_2> <DESCRIPTION> поле необязательно.
Списки с ASN
Элементы в пользовательских списках номеров автономных систем (ASN) должны быть целыми числами.
Например, для списка с ASN допустимы следующие записи:
11333564512
Формат файла CSV
При загрузке элементов в пользовательский список с ASN через файл CSV используйте следующий формат файла:
<ASN_1>,<DESCRIPTION>
<ASN_2> <DESCRIPTION> поле необязательно.
