INTEGRITY Dokumentace

Vlastní chyby

Pomocí Custom Errors nahraďte výchozí chybové stránky Cloudflare vlastním obsahem. Vlastní chybový obsah se návštěvníkům zobrazí při výskytu chyby HTTP, ať už chyba pochází z vašeho origin serveru, produktu Cloudflare (včetně Cloudflare Workers), nebo bezpečnostní výzva.

Vlastní obsah chybové stránky můžete nakonfigurovat následujícími způsoby:

Vlastní chyby vyžadují, abyste zapnout proxy u DNS záznamů vaší domény (nebo subdomény) přes Cloudflare.

Jak to funguje

Cloudflare nabízí sadu výchozích stránek pro zobrazování chyb a challenges návštěvníkům vašeho webu. Tyto stránky můžete přizpůsobit pomocí Error Pages a Custom Error Rules.

Když chyba typu konkrétní typ nastane, Cloudflare provede následující:

  1. Vyhledá nakonfigurovanou Error Page na úrovni účtu pro danou chybu.
  2. Vyhledá nakonfigurovanou Error Page na úrovni zóny pro danou chybu (bude mít přednost před Error Page na úrovni účtu, pokud existuje).
  3. Vyhledá odpovídající vlastní pravidlo chyby na úrovni účtu. Toto pravidlo bude mít přednost před třída 500 a třída 1000 Error Pages na úrovni účtu nebo zóny.
  4. Vyhledá odpovídající vlastní pravidlo chyby na úrovni zóny. Toto pravidlo bude mít přednost před třída 500 a třída 1000 Error Pages na úrovni účtu nebo zóny a nad vlastními pravidly chyb na úrovni účtu.
  5. Pokud bezpečnostní pravidlo, jako je Vlastní pravidlo WAF nebo pravidlo pro omezení frekvence aktivuje vlastní blokovací odpověď namísto výchozí blokovací stránky Cloudflare WAF, má tato blokovací odpověď specifická pro dané pravidlo přednost před Error Pages nebo odpovídajícím vlastním chybovým pravidlem.
  6. Pokud platí některá z výše uvedených konfigurací, zobrazte návštěvníkovi vlastní chybový obsah. Pokud ne, zobrazte výchozí chybovou stránku pro daný typ chyby ve formátu, který klient požadoval (JSON, Markdown nebo HTML). Další podrobnosti o strukturovaných chybových odpovědích (JSON nebo Markdown) najdete v Chybové odpovědi.

Dostupnost

Vlastní chyby jsou dostupné ve všech placených plánech. Konkrétní funkce závisí na vašem plánu Cloudflare.

Free Pro Business Enterprise
Dostupnost Ne Ano Ano Ano
Počet pravidel 0 25 50 300
Počet prostředků 0 25 50 300
Chybové stránky Ne Ano Ano Ano
Origin Error Pages Ne Ne Ne Ano

Chybové stránky

Cloudflare využívá širokou škálu chybové kódy k identifikaci problémů se zpracováním provozu požadavků. Ve výchozím nastavení tyto chybové stránky uvádějí Cloudflare, můžete si však vytvořit vlastní chybové stránky, které vašim uživatelům poskytnou jednotný dojem z vaší značky.

Chybové stránky se nepoužívají u odpovědí se stavovým kódem HTTP 500, 501, 503, nebo 505. Tyto výjimky pomáhají předcházet problémům s konkrétními API endpointy a dalšími webovými aplikacemi. Odpovědi pro tyto stavové kódy můžete i nadále přizpůsobit pomocí Custom Error Rules.

Pokud máte placený plán Cloudflare, můžete vytvářet vlastní chybové stránky na úrovni zóny nebo pro celý účet. Chybové stránky na úrovni zóny mají přednost před chybovými stránkami na úrovni účtu.

Zákazníci s plánem Enterprise navíc mohou přizpůsobit chybové stránky 5XX (kromě chyb 520-527) na svém origin serveru zapnutím Origin Error Pages v Chybové stránky v dashboardu.

Můžete navrhnout vlastní chybové stránky, které se zobrazí během bezpečnostní výzvy nebo při chybě. Další informace o jednotlivých typech chybových stránek najdete v Typy chybových stránek.

Vlastní pravidla chyb

Vlastní chybové pravidlo definuje podmínky, za kterých Cloudflare zobrazí návštěvníkům vlastní chybový obsah v případě chyb HTTP (stavové kódy 400 a vyšší) a přesný obsah, který se návštěvníkům zobrazí.

Při definování obsahu, který se má poskytovat, zadáte buď přímou (inline) odpověď, nebo URL adresu existující webové stránky. URL adresa může odkazovat na webovou stránku nebo na jiný zdroj, například obsah JSON.

Když zadáte URL adresu, Cloudflare shromáždí všechny potřebné obrázky, CSS a JavaScript kód a uloží minifikovanou verzi celé stránky do globální sítě Cloudflare. Tento zdroj se nazývá vlastní chybové aktivum, který můžete použít v jednom nebo více vlastních pravidlech chyb ve stejném rozsahu prostředku (zóna nebo účet).

Když se spustí custom error rule, Cloudflare nahradí tělo odpovědi dříve definovanou odpovědí a volitelně i HTTP stavovým kódem odeslaným návštěvníkovi. Existující hlavičky HTTP odpovědi si Cloudflare ponechá, s výjimkou Content-Type a Content-Length.

Navíc můžete nastavit Response Header Transform Rules pro chybové odpovědi, abyste přidali, změnili nebo odebrali hlavičky HTTP z odpovědi.

Vlastní pravidla chyb mají přednost před Chybové stránky.

Vlastní chybová aktiva

Vlastní chybový zdroj odpovídá webovému zdroji, například HTML stránce (včetně všech odkazovaných obrázků, CSS a kódu JavaScript), který Cloudflare načte a uloží na základě vámi zadané URL, aby ho následně zobrazovala návštěvníkům jako chybovou stránku.

Jakmile je vlastní chybový prostředek uložen v globální síti Cloudflare, URL adresa, kterou jste původně zadali, už nemusí být dostupná. Existující vlastní chybový prostředek můžete aktualizovat jeho opětovným načtením. Metadata každého vlastního chybového prostředku zahrnují časové razítko posledního načtení, které se zobrazuje na dashboardu.

Vlastní chybový asset můžete použít v jednom nebo více vlastní chybová pravidla ve stejném rozsahu, ve kterém jste definovali objekt (zóna nebo účet).

Omezení velikosti

Když zadáte URL adresu pro vlastní chybový asset, Cloudflare stránku načte a všechny odkazované zdroje vloží přímo do HTML. Obrázky a další binární zdroje (včetně těch odkazovaných z CSS pomocí url(...)) jsou vloženy jako datové URL adresy zakódované pomocí base64. Soubory CSS a JavaScript jsou vloženy jako prostý text uvnitř <style> a <script> značek. Zpracovaná stránka nesmí přesáhnout přibližně 1.5 MB.

Pokud váš vlastní chybový asset tuto velikost překročí, omezte počet nebo velikost odkazovaných zdrojů. Velké zdroje můžete hostovat i externě, pokud zůstanou dostupné ze sítě Cloudflare ve chvíli, kdy je asset načítán.