← Dokumentace WAF / detections / application-profiles

Schema Profiles

Schema Profile modeluje očekávaná pole požadavku a jejich omezení. Můžete jej nechat vytvořit na základě provozu, nebo dodat nahrané schéma.

Jakmile je profil k dispozici, Cloudflare spustí nepřetržitá detekce. Detekce sama o sobě požadavky nezmírňuje.

Operace je termín Cloudflare pro endpoint. Jeho identita kombinuje metodu HTTP, vzor hostname a vzor cesty.

Webová aktiva průběžně zjišťuje operace v rámci Webová aktiva > Operace. Operaci můžete také přidat ručně.

Obě metody pouze přidávají operace do inventáře. Chcete-li zahájit profilování, vyberte Naučit profil z nabídky s dalšími možnostmi dané operace.

Učení probíhá týdně na základě kvalifikovaného provozu za předchozích sedm dní. Zahrnuty jsou pouze požadavky, které obdržely 2xx odpověď přispívá.

Prahová hodnota pro učení polí vyžaduje 1,000 kvalifikujících požadavků. Prahová hodnota pro učení hranic vyžaduje 10,000 kvalifikujících požadavků.

Prahová hodnota pro učení polí umožňuje Cloudflare rozpoznávat pole požadavků. Prahová hodnota pro učení hranic umožňuje Cloudflare rozpoznávat omezení, jako jsou číselné rozsahy a délky řetězců.

První profil se zobrazí po dalším týdenním běhu učení. To může trvat až sedm dní od splnění příslušné prahové hodnoty.

V nabídce s dalšími možnostmi dané operace vyberte Zobrazit podrobnosti. Naučené schéma se zobrazí v části Přehled zabezpečení.

Profily se mohou naučit tyto komponenty požadavku, pokud jsou podporovány:

• Proměnné cesty
• Parametry dotazu
• Hlavičky a cookies
• JSON request bodies
• Form-encoded request bodies

Profily dokážou validovat celá čísla, řetězce, univerzálně jedinečné identifikátory (UUID) a pole. Mezi podporovaná omezení patří číselné rozsahy, délky řetězců, znakové třídy a výčty obsahující až tři hodnoty.

Úspěšný provoz může zahrnovat boty, skenery nebo škodlivé požadavky. Před vynucením detekce podle naučeného profilu si ho proto zkontrolujte.

Každé týdenní spuštění může profil aktualizovat podle změn kvalifikovaného provozu. U pevného schématu export naučeného schématu jako OpenAPI a nahrajte jej k ověření.

Naučené profily Schema Profile mají tato omezení:

• Multipart formuláře, GraphQL a XML nejsou podporovány.
• U opakovaných parametrů se ověřuje každá hodnota zvlášť, bez vynucení jedinečnosti.
• Přítomnost povinného parametru se nevynucuje.
• Samotné nové parametry nezpůsobují porušení.
• Omezení platí pro naučená pole, nikoli pro úplný allowlist.

Nahrané schéma OpenAPI poskytuje očekávanou strukturu místo pozorovaného provozu. Detekce vytváří pomocí cf.schema_validation.uploaded.violated.

API Shield poskytuje podrobné Reference ověřování schématu. Zahrnuje podporované verze, postupy importu, pole OpenAPI, limity těla požadavku a řešení problémů.

Informace o automatizaci najdete v API a Terraform instrukce.