← Dokumentace WAF / tools

Seznamy

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

Můžete si vytvořit vlastní vlastní seznamy nebo použijte Spravované seznamy spravovaných společností Cloudflare, jako jsou Managed IP Lists, které poskytují data threat intelligence.

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

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

Když aktualizujete obsah seznamu, všechna pravidla, která tento seznam používají, se automaticky aktualizují. Stačí tedy provést jedinou změnu v seznamu místo úpravy jednotlivých pravidel.

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

Cloudflare podporuje následující seznamy:

• Vlastní seznamy: Zahrnuje vlastní seznamy IP adres, seznamy hostname a seznamy ASN.
• Spravované seznamy: Seznamy správované a aktualizované Cloudflare, například Managed IP Lists.

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

Můžete také použít vložené seznamy ve výrazech pravidel. Vložené seznamy umožňují zahrnout hodnoty přímo do výrazu bez nutnosti nejprve vytvořit samostatný seznam. Jakákoli změna hodnot si však vyžádá ú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 (_) ve svém 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 vytvořit seznamy v dashboardu Cloudflare nebo pomocí Lists API.

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

Seznamy podporuje jak dashboard Cloudflare, tak API Cloudflare:

• Chcete-li použít seznamy ve výrazu z Cloudflare dashboardu, přečtěte si Použití seznamů ve výrazech.
• Chcete-li odkázat na seznam ve výrazu API, přečtěte si Seznamy v referenční dokumentaci jazyka Rules language.

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

U IP seznamů vrací Cloudflare adresy IP nebo rozsahy, které začínají vaším vyhledávaným dotazem. Pokud například vyhledáte 192.0.2 odpovídá 192.0.2.1 a 192.0.2.0/24, ale hledáním 192.0.2.100 neodpovídá Rozsah CIDR jako 192.0.2.0/24 který obsahuje tuto adresu.

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

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

Poznámky:

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

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

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

• Zákazníci s plánem Enterprise mohou v případě potřeby dalších vlastních seznamů nebo vyššího maximálního počtu položek napříč seznamy kontaktovat svůj account team.

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

Následující role uživatelů mají přístup ke správě seznamů:

• Super Administrator
• Administrator
• Firewall

Seznam můžete odstranit pouze v případě, že 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 pomocí souboru CSV) uplatní Cloudflare následující pravidla:

• Před aktualizací nebo přidáním položek neodstraňujte žádné existující položky seznamu.
• Aktualizace položek, které již byly v seznamu.
• Přidejte položky, které v seznamu chyběly.

Chcete-li najednou nahradit celý obsah seznamu, naformátujte data jako pole a použijte Aktualizace všech položek seznamu operaci v Lists API.

Dashboard Cloudflare nepodporuje stahování seznamu jako souboru CSV. Chcete-li exportovat obsah seznamu, použijte Získání položek seznamu operace API.