INTEGRITY Dokumentace

Rozpoznání odpovědi Challenge Page

Když požadavek místo původně očekávané odpovědi narazí na Cloudflare Challenge Page, bude mít odpověď Challenge Page (bez ohledu na její typ) cf-mitigated hlavičku přítomnou a nastavenou na challenge. Tuto hlavičku lze využít ke zjištění, zda byla odpověď při požadavcích fetch nebo XHR podrobena výzvě. Poskytuje spolehlivý způsob, jak zjistit, zda je odpověď výzvou, nebo ne, a webová aplikace tak může na základě výsledku podniknout odpovídající kroky. Frontendová aplikace, která narazí na odpověď z backendu, může například zkontrolovat přítomnost této hlavičky a ošetřit tak případy, kdy se neočekávaně objeví stránka Challenge Page.

Pro cf-mitigated hlavička, challenge je jediná platná hodnota. Tato hlavička se nastavuje pro všechny typy Challenge Page.

Pro ilustraci uvádíme ukázku kódu v JavaScriptu, která demonstruje použití cf-mitigated hlavičku ke zjištění, zda odpověď prošla Challenge:

fetch("/my-api-endpoint").then((response) => {
	if (response.headers.get("cf-mitigated") === "challenge") {
		// Handle challenged response
	} else {
		// Process response as usual
	}
});