← Dokumentace WAF / tools / lists
Vlastní seznamy
Vlastní seznam obsahuje jednu nebo více položek stejného typu (například IP adresy, hostname nebo ASN), na které se můžete ve výrazech pravidel odkazovat hromadně, podle názvu.
Cloudflare podporuje následující typy vlastních seznamů:
- Seznamy s IP adresami (známé také jako seznamy IP adres)
- Seznamy s názvy hostitelů
- Seznamy s ASN (autonomní systém ↗ čísel)
Každý typ má vlastní vlastnosti a formát souboru CSV. Podrobnosti najdete v následujících částech.
Další informace o seznamech spravovaných Cloudflare, jako jsou Managed IP Lists, najdete v Spravované seznamy.
Vytvoření vlastního seznamu
Viz Vytvoření seznamu v dashboardu nebo na Lists API stránce.
Použití vlastního seznamu
Použití vlastních seznamů v pravidle výrazy hodnotou in operátor a pole podporované vlastním seznamem:
<FIELD> in $<LIST_NAME>Pole, která můžete použít, se liší podle typu položky seznamu:
| Typ položky seznamu | Dostupná pole |
|---|---|
| IP adresa | Pole s typem IP address uvedené v Přehled polí |
| Hostname | http.host |
| ASN | ip.src.asnum |
Další informace a příklady najdete v Použití seznamů ve výrazech.
Typy vlastních seznamů
Seznamy s IP adresami (IP seznamy)
Položky ve vlastních seznamech IP adres musí mít jeden z následujících formátů:
- Jednotlivé adresy IPv4
- Jednotlivé adresy IPv6
- Rozsahy IPv4 CIDR s prefixem od
/8na/32 - Rozsahy IPv6 CIDR s prefixem od
/12na/128
Stejný seznam může obsahovat jak jednotlivé adresy, tak rozsahy CIDR.
Pro adresy IPv6 v seznamech můžete použít velká i malá písmena. Při uložení seznamu se však velká písmena převedou na malá.
Formát souboru CSV
Při nahrávání položek do vlastního seznamu s IP adresami přes soubor CSV použijte následující formát souboru (na každý řádek zadejte jednu položku):
<IP_ADDRESS_1>,<DESCRIPTION>
<IP_ADDRESS_2> <DESCRIPTION> pole je volitelné.
Seznamy s názvy hostitelů
Položky ve vlastních seznamech názvů hostitelů musí být plně kvalifikované názvy domén (FQDN). Položka může obsahovat * zástupný znak předpony/subdomény, za kterým musí následovat . (období). Položka nesmí obsahovat schéma (například https://) nebo cesta URL.
Pro vlastní seznam s názvy hostitelů by například byly platné tyto položky:
example.comapi.example.com*.example.com
Nicméně, example.com/path/subfolder by nebyl platný záznam.
Do vlastního seznamu s hostiteli můžete přidat libovolný platný hostitelský název (platný FQDN). Tyto hostitelské názvy nemusí patřit k aktuálnímu účtu Cloudflare.
Formát souboru CSV
Při nahrávání položek do vlastního seznamu s hostname přes soubor CSV použijte následující formát souboru:
<HOSTNAME_1>,<DESCRIPTION>
<HOSTNAME_2> <DESCRIPTION> pole je volitelné.
Seznamy s ASN
Položky ve vlastních seznamech čísel autonomních systémů (ASN) musí být celočíselné hodnoty.
Pro seznam s ASN by například byly platné tyto položky:
11333564512
Formát souboru CSV
Při nahrávání položek do vlastního seznamu s ASN přes soubor CSV použijte následující formát souboru:
<ASN_1>,<DESCRIPTION>
<ASN_2> <DESCRIPTION> pole je volitelné.
