INTEGRITY Dokumentace

← Dokumentace WAF / tools / lists

Vlastní seznamy

Vlastní seznam obsahuje jednu nebo více položek stejného typu (například IP adresy, hostnames nebo ASN), na které se můžete ve výrazech pravidel odkazovat souhrnně podle názvu.

Cloudflare podporuje následující typy vlastních seznamů:

Každý typ má vlastní vlastnosti a formát souboru CSV. Podrobnosti najdete v následujících sekcích.

Další informace o seznamech spravovaných Cloudflarem, jako jsou Managed IP Lists, najdete v Managed Lists.

Vytvoření vlastního seznamu

Viz Vytvoření seznamu v dashboardu nebo do Lists API stránku.

Použití vlastního seznamu

Používejte vlastní seznamy v výrazy s in operátorem a s polem podporovaným daným 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 Reference polí
Hostname http.host
ASN ip.src.asnum

Více informací a příklady najdete v Použití seznamů ve výrazech.

Typy vlastních seznamů

Seznamy s IP adresami (IP listy)

Položky ve vlastních seznamech s IP adresami musí mít jeden z následujících formátů:

Stejný seznam může obsahovat jak jednotlivé adresy, tak CIDR rozsahy.

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 (zadejte jednu položku na řádek):

<IP_ADDRESS_1>,<DESCRIPTION>
<IP_ADDRESS_2>

The <DESCRIPTION> pole je volitelné.

Seznamy s hostnames

Položky ve vlastních seznamech s hostnames musí být plně kvalifikované doménové názvy (FQDN). Položka může obsahovat * wildcard pro prefix/subdoménu, po kterém musí následovat . (tečka). Položka nemůže obsahovat schéma (například https://) nebo cestu URL.

Například následující položky by byly platné pro vlastní seznam s hostnames:

Nicméně example.com/path/subfolder by nebyla platná položka.

Do vlastního seznamu s hostnames můžete přidat jakýkoli platný hostname (platné FQDN). Hostnames 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 hostnames přes soubor CSV použijte následující formát souboru:

<HOSTNAME_1>,<DESCRIPTION>
<HOSTNAME_2>

The <DESCRIPTION> pole je volitelné.

Seznamy s ASN

Položky ve vlastních seznamech s čísly autonomních systémů (ASN) musí být celočíselné hodnoty.

Například následující položky by byly platné pro seznam s ASN:

Formát souboru CSV

Při nahrávání položek do vlastního seznamu s ASN přes CSV soubor použijte následující formát souboru:

<ASN_1>,<DESCRIPTION>
<ASN_2>

The <DESCRIPTION> pole je volitelné.