← Dokumentace WAF / tools

Seznamy

Seznamy umožňují seskupovat položky, jako jsou IP adresy, hostitelé nebo čísla autonomních systémů (ASN), a odkazovat na ně jménem v Cloudflare výrazy pravidel. Místo přidávání každé položky jednotlivě do každého pravidla, které ji potřebuje, definujete skupinu jednou a opakovaně ji používáte napříč pravidly a zónami.

Můžete vytvořit vlastní vlastní seznamy nebo použijte Managed Lists udržované Cloudflarem, jako jsou Managed IP Lists poskytující threat intelligence data.

Seznamy mají následující výhody:

• Při vytváření pravidla je použití seznamu snazší a méně náchylné k chybám než přidávání dlouhého výčtu položek, jako jsou IP adresy, do výrazu pravidla.
• Při aktualizaci sady pravidel cílících na stejnou skupinu IP adres (nebo hostname) je použití IP seznamu (nebo seznamu hostname) jednodušší a méně náchylné k chybám než úprava více pravidel.
• Seznamy se snáze čtou a jsou informativnější, zvláště když pro ně používáte popisné názvy.

Když aktualizujete obsah seznamu, všechna pravidla, která seznam používají, se automaticky aktualizují — stačí tedy jediná změna v seznamu místo úprav jednotlivých pravidel.

Cloudflare ukládá vaše seznamy na úrovni účtu. Stejný seznam můžete používat v pravidlech různých zón ve svém účtu Cloudflare.

Cloudflare podporuje následující seznamy:

• Vlastní seznamy: Zahrnuje vlastní IP seznamy, seznamy hostname a seznamy ASN.
• Managed Lists: Seznamy spravované a aktualizované Cloudflarem, například Managed IP Lists.

Podrobnosti najdete na jednotlivých stránkách.

Můžete také použít inline seznamy ve výrazech pravidel. Inline seznamy umožňují zahrnout hodnoty přímo do výrazu bez nutnosti nejprve vytvářet samostatný seznam. Jakákoli změna hodnot však vyžaduje úpravu samotného pravidla.

Název seznamu musí splňovat následující požadavky:

• Název používá pouze malá písmena, číslice a podtržítko (_) znak v názvu. Platný název odpovídá tomuto regulárnímu výrazu: ^[a-z0-9_]+$.
• Maximální délka názvu seznamu je 50 znaků.

Můžete vytvářet seznamy v Cloudflare dashboardu nebo pomocí Lists API.

Po vytvoření seznamu můžete položky přidávat a odebírat, ale nemůžete změnit jeho název ani typ.

Seznamy podporuje jak Cloudflare dashboard, tak Cloudflare API:

• Použití seznamů ve výrazu z Cloudflare dashboardu je popsáno v Použití seznamů ve výrazech.
• Odkazování na seznam ve výrazu v API viz Seznamy v referenci jazyka Rules.

Položky seznamu můžete vyhledávat v dashboardu nebo přes API.

U IP seznamů Cloudflare vrací IP adresy nebo rozsahy začínající vaším hledaným výrazem. Například hledání 192.0.2 odpovídá 192.0.2.1 a 192.0.2.0/24, ale vyhledávání 192.0.2.100 neodpovídá Rozsah CIDR jako 192.0.2.0/24 který danou adresu obsahuje.

U Bulk Redirect Lists vrací Cloudflare položky, jejichž zdrojová nebo cílová URL obsahuje váš vyhledávací dotaz.

Dostupnost seznamů se liší podle typu seznamu a vašeho plánu Cloudflare a předplatných.

Poznámky:

• Počet dostupných vlastních seznamů závisí na nejvyšším plánu ve vašem účtu. Každý účet s alespoň jedním placeným plánem získá nejvyšší kvótu.

• Zákazníci na plánech Enterprise mohou vytvořit celkem maximálně 1 000 vlastních seznamů napříč různými typy seznamů. Platí následující dodatečné limity:

  • Až 40 seznamů hostname s maximálně 10 000 položkami napříč všemi seznamy hostname.
  • Až 40 ASN seznamů, s maximem 30 000 položek napříč všemi ASN seznamy.

• Zákazníci na plánech Enterprise mohou kontaktovat svůj account tým, pokud potřebují více vlastních seznamů nebo vyšší maximální počet položek napříč seznamy.

• Podrobnosti o dostupnosti Bulk Redirect Lists najdete v Pravidla dokumentaci.

Přístup k funkcím správy seznamů mají následující uživatelské role:

• Super Administrator
• Administrator
• Firewall

Seznam lze smazat, pouze pokud na něj neodkazují žádná pravidla (povolená ani zakázaná).

Při přidávání položek do existujícího seznamu (ručně nebo přes CSV soubor) Cloudflare uplatní následující pravidla:

• Před aktualizací/přidáváním položek neodstraňujte žádné existující položky seznamu.
• Aktualizovat položky, které už v seznamu byly.
• Přidá položky, které v seznamu nebyly.

Pro nahrazení celého obsahu seznamu najednou naformátujte data jako pole a použijte Aktualizace všech položek seznamu operaci v Lists API.

Cloudflare dashboard nepodporuje stažení seznamu jako CSV souboru. K exportu obsahu seznamu použijte Získání položek seznamu operace API.