INTEGRITY Dokumentace

Požadavky HTTP

Následující popisy podrobně uvádějí pole dostupná pro http_requests.

AISecurityCustomTopicCategories

Typ: object

Zákazníkem definované štítky témat AI Security a jejich skóre relevance. Skóre 1 znamená nejvyšší relevanci a skóre 99 nejnižší relevanci.

AISecurityInjectionScore

Typ: int

Skóre udávající pravděpodobnost útoku prompt injection v požadavku, jak jej určila AI Security.

AISecurityPIICategories

Typ: array[string]

Seznam kategorií PII zjištěných v požadavku pomocí AI Security.

AISecurityTokenCount

Typ: int

Počet tokenů v požadavku, jak je zjistila služba AI Security.

AISecurityUnsafeTopicCategories

Typ: array[string]

Seznam kategorií nebezpečných témat zjištěných v požadavku pomocí AI Security.

BotDetectionIDs

Typ: array[int]

Seznam ID odpovídajících heuristickým detekcím Bot Management u daného požadavku. K dispozici pouze pro zákazníky Bot Management. Pokud chcete tuto funkci povolit, obraťte se na tým odpovědný za váš účet.

BotDetectionTags

Typ: array[string]

Seznam tagů odpovídajících heuristickým detekcím Bot Management u daného požadavku. K dispozici pouze pro zákazníky Bot Management. Pokud chcete tuto funkci povolit, obraťte se na tým odpovědný za váš účet.

BotScore

Typ: int

Cloudflare Bot Score. Skóre pod 30 obvykle souvisí s automatizovaným provozem. Dostupné pouze pro zákazníky služby Bot Management. Chcete-li tuto funkci povolit, obraťte se na tým odpovědný za váš účet.

BotScoreSrc

Typ: string

Detekční modul zodpovědný za generování Bot Score.
Možné hodnoty jsou Nevypočítáno | Heuristiky | Machine Learning | Analýza chování | Verified Bot | JS Fingerprinting | Cloudflare Service. K dispozici pouze pro zákazníky Bot Management. Pokud chcete tuto funkci povolit, obraťte se na tým odpovědný za váš účet.

BotTags

Typ: array[string]

Typ provozu robotů (pokud je k dispozici). Podrobnosti najdete v Štítky botů pro seznam možných hodnot. K dispozici pouze pro zákazníky Bot Management. Pokud chcete tuto funkci povolit, kontaktujte svůj tým podpory účtu.

CacheCacheStatus

Typ: string

Stav mezipaměti.
Možné hodnoty jsou unknown | miss | vypršelý | updating | stale | hit | ignored | Bypass | revalidated | dynamický | stream_hit | deferred
"dynamic" znamená, že požadavek není způsobilý pro ukládání do mezipaměti. To může znamenat například, že jej zablokoval firewall. Více informací najdete v Odpovědi mezipaměti Cloudflare pro další podrobnosti.

CacheLockWaitedMs

Typ: int

Maximální doba čekání na zámek cache napříč všemi úrovněmi cache, v milisekundách.

CacheReserveUsed

Typ: bool

K obsloužení tohoto požadavku byla použita Cache Reserve.

CacheResponseBytes

Typ: int

Počet bajtů vrácených z mezipaměti.

CacheResponseStatus (zastaralé)

Typ: int

Stavový kód HTTP vrácený mezipamětí edge serveru. Všechny požadavky (včetně těch, které nelze ukládat do mezipaměti) procházejí mezipamětí. Viz také pole CacheCacheStatus.

CacheTieredFill

Typ: bool

Pro obsloužení tohoto požadavku byla použita funkce Tiered Cache.

ClientASN

Typ: int

Číslo AS klienta.

ClientCity

Typ: string

Přibližné město klienta.

ClientCountry

Typ: string

Dvoupísmenný kód země podle ISO-3166 pro IP adresu klienta.

ClientDeviceType

Typ: string

Typ zařízení klienta.

ClientIP

Typ: string

IP adresa klienta.

ClientIPClass

Typ: string

Třída IP adresy klienta.
Možné hodnoty jsou unknown | badHost | searchEngine | allowlist | monitoringService | noRecord | scan | tor.

ClientLatitude

Typ: string

Přibližná zeměpisná šířka klienta.

ClientLongitude

Typ: string

Přibližná zeměpisná délka klienta.

ClientMTLSAuthCertFingerprint

Typ: string

Otisk SHA256 certifikátu předloženého klientem během ověřování mTLS. Vyplňuje se pouze u prvního požadavku v rámci připojení mTLS.

ClientMTLSAuthStatus

Typ: string

Stav ověření mTLS. Vyplňuje se pouze u prvního požadavku na připojení mTLS.
Možné hodnoty jsou unknown | ok | absent | untrusted | notyetvalid | vypršelý.

ClientRegionCode

Typ: string

Kód regionu podle ISO-3166-2 pro IP adresu klienta.

ClientRequestBytes

Typ: int

Počet bajtů v požadavku klienta.

ClientRequestHost

Typ: string

Hostitel požadovaný klientem.

ClientRequestMethod

Typ: string

Metoda HTTP požadavku klienta.

ClientRequestPath

Typ: string

Cesta URI požadovaná klientem, která zahrnuje pouze část cesty požadované adresy URL bez řetězce dotazu.

ClientRequestProtocol

Typ: string

Protokol HTTP požadavku klienta.

ClientRequestReferer

Typ: string

Referrer HTTP požadavku.

ClientRequestScheme

Typ: string

Schéma URL požadované návštěvníkem.

ClientRequestSource

Typ: string

Určuje, zda požadavek pochází z externího zdroje, nebo z jiné služby v rámci Cloudflare. Více informací najdete v Pole ClientRequestSource pro seznam možných hodnot.

ClientRequestURI

Typ: string

URI požadované klientem, které zahrnuje celou cestu a řetězec dotazu požadované adresy URL.

ClientRequestUserAgent

Typ: string

User agent nahlášený klientem.

ClientSSLCipher

Typ: string

Šifra SSL klienta.

ClientSSLProtocol

Typ: string

Protokol SSL (TLS) klienta. Hodnota „none“ znamená, že SSL nebylo použito.

ClientSrcPort

Typ: int

Zdrojový port klienta.

ClientTCPRTTMs

Typ: int

Vyhlazený průměr doby odezvy TCP (SRTT, round-trip time). U prvního požadavku na připojení se měří pouze během navazování spojení. U dalších požadavků na stejném připojení se měří po celou dobu trvání připojení až do okamžiku přijetí daného požadavku.

ClientTLSKeyExchangeGroup

Typ: string

Skupina pro výměnu klíčů TLS mezi klientem a Cloudflare (například 'X25519MLKEM768'). Hodnota 'UNK' znamená, že ji nebylo možné určit. Hodnota 'NONE' znamená, že TLS nebylo použito.

ClientXRequestedWith

Typ: string

HTTP hlavička X-Requested-With.

ContentScanObjResults

Typ: array[string]

Seznam výsledků kontroly obsahu.

ContentScanObjSizes

Typ: array[int]

Seznam velikostí objektů obsahu.

ContentScanObjTypes

Typ: array[string]

Seznam typů obsahu.

Cookies

Typ: object

Řetězcové páry klíč-hodnota pro cookies. Toto pole se vyplňuje na základě Vlastní pole Logpush, které je třeba nakonfigurovat.

EdgeCFConnectingO2O

Typ: bool

Hodnota true, pokud požadavek prošel více zónami na hraně sítě Cloudflare. Takový požadavek se považuje za O2O.

EdgeColoCode

Typ: string

Kód IATA letiště datacentra, které přijalo požadavek.

EdgeColoID

Typ: int

ID edge datacentra Cloudflare.

EdgeEndTimestamp

Typ: int or string

Časové razítko okamžiku, kdy edge dokončil odesílání odpovědi klientovi.

EdgePathingOp

Typ: string

Udává, jaký typ odpovědi byl pro tento požadavek vydán (unknown = žádná konkrétní akce).

EdgePathingSrc

Typ: string

Popisuje, jak byl požadavek klasifikován na základě bezpečnostních kontrol (unknown = žádná konkrétní klasifikace).

EdgePathingStatus

Typ: string

Udává, jaká data byla použita k určení způsobu zpracování tohoto požadavku (unknown = žádná data).

EdgeRequestHost

Typ: string

Hlavička Host v požadavku z edge serveru na origin server.

EdgeResponseBodyBytes

Typ: int

Velikost těla HTTP odpovědi vrácené klientům.

EdgeResponseBytes

Typ: int

Počet bajtů vrácených z edge serveru klientovi.

EdgeResponseCompressionRatio

Typ: float

Poměr komprese odpovědi na edge serveru se počítá jako poměr mezi velikostí původní a komprimované odpovědi.

EdgeResponseContentType

Typ: string

Hodnota hlavičky Content-Type v odpovědi z edge.

EdgeResponseStatus

Typ: int

Stavový kód HTTP vrácený klientovi službou Cloudflare.

EdgeServerIP

Typ: string

IP adresa edge serveru, který odesílá požadavek na origin. Možnou hodnotou je řetězec ve formátu IPv4 nebo IPv6, nebo prázdný řetězec. Prázdný řetězec znamená, že na origin server nebyl odeslán žádný požadavek.

EdgeStartTimestamp

Typ: int or string

Časové razítko okamžiku, kdy edge přijal požadavek od klienta.

EdgeTimeToFirstByteMs

Typ: int

Celkový pohled na Time To First Byte měřený na hraně sítě Cloudflare. Měření začíná po navázání připojení TCP a končí ve chvíli, kdy Cloudflare začne koncovým uživatelům vracet první bajt odpovědi. Zahrnuje dobu handshake TLS (u nových připojení) i dobu odezvy origin serveru.

FirewallForAIInjectionScore (zastaralé)

Typ: int

Skóre udávající pravděpodobnost útoku prompt injection v požadavku, jak jej určil Firewall for AI. Zastaralé: Místo toho použijte AISecurityInjectionScore.

FirewallForAIPIICategories (zastaralé)

Typ: array[string]

Seznam kategorií PII zjištěných v požadavku pomocí Firewall for AI. Zastaralé: Místo toho použijte AISecurityPIICategories.

FirewallForAITokenCount (zastaralé)

Typ: int

Počet tokenů v požadavku, jak je zjistila služba Firewall for AI. Zastaralé: místo toho použijte AISecurityTokenCount.

FirewallForAIUnsafeTopicCategories (zastaralé)

Typ: array[string]

Seznam kategorií nebezpečných témat zjištěných v požadavku pomocí Firewall for AI. Zastaralé: Místo toho použijte AISecurityUnsafeTopicCategories.

FraudAttack

Typ: string

Hlavní útok nebo případ užití zjištěný v požadavku pomocí detekce podvodů.

FraudDetectionIDs

Typ: array[int]

Seznam ID odpovídajících detekcím podvodů u daného požadavku.

FraudDetectionTags

Typ: array[string]

Seznam tagů odpovídajících detekcím podvodů u daného požadavku.

FraudEmailRisk

Typ: string

Riziko konkrétní e-mailové adresy.
Možné hodnoty jsou nízká | medium | vysoká.

FraudUserID

Typ: string

Jedinečný identifikátor, který systém Fraud Detection vygeneruje pro každého uživatele během libovolné akce určené typem události podvodu.

JA3Hash

Typ: string

Hash MD5 otisku JA3 použitého k profilování klientů SSL/TLS. Dostupné pouze pro zákazníky Bot Management. Chcete-li tuto funkci povolit, kontaktujte svůj account team.

JA4

Typ: string

Otisk JA4 použitý k profilování klientů SSL/TLS. Dostupné pouze pro zákazníky Bot Management. Chcete-li tuto funkci povolit, kontaktujte svůj account team.

JA4Signals

Typ: object

Statistiky mezi požadavky vypočítané pro tento otisk JA4. Pole JA4Signals je uspořádáno jako dvojice klíč:hodnota, přičemž hodnoty jsou čísla. K dispozici pouze pro zákazníky Bot Management. Chcete-li tuto funkci povolit, obraťte se na tým odpovědný za váš účet.

JSDetectionPassed

Typ: string

Zda požadavek prošel kontrolou JavaScript Detection na pozadí.
Možné hodnoty jsou passed | failed | missing. K dispozici pouze pro zákazníky Bot Management. Pokud chcete tuto funkci povolit, obraťte se na tým odpovědný za váš účet.

LeakedCredentialCheckResult

Typ: string

Výsledek kontroly uniklé přihlašovací údaje.
Možné výsledky jsou: password_leaked | username_and_password_leaked | username_password_similar | username_leaked | clean.

MatchedRules

Typ: array[object]

Pole odpovídajících pravidel produktů Cloudflare Rules seskupených podle produktu. Každý objekt obsahuje: product (string, například snippets, transform, redirects), rulesetId (string), rulesetVersion (int) a pravidla (pole objektů, z nichž každý obsahuje id (string) a volitelný metadata (objekt s páry klíč-hodnota typu string)).

OriginDNSResponseTimeMs

Typ: int

Doba potřebná k přijetí odpovědi DNS pro název origin serveru. Obvykle trvá několik milisekund, ale může být delší, pokud se používá záznam CNAME.

OriginIP

Typ: string

IP adresa origin serveru.

OriginRequestHeaderSendDurationMs

Typ: int

Doba potřebná k odeslání hlaviček požadavku na origin server po navázání připojení. Tato hodnota je obvykle 0.

OriginResponseBytes (zastaralé)

Typ: int

Počet bajtů vrácených origin serverem. Zvažte použití pole CacheResponseBytes a vyfiltrování hodnot OriginResponseStatus 0 a 304, které označují znovu ověřenou (revalidovanou) odpověď. Viz Výpočet bajtů obsloužených originem.

OriginResponseDurationMs

Typ: int

Doba odezvy upstreamu měřená od prvního datacentra, které požadavek přijme. Zahrnuje čas strávený službami Argo Smart Routing a Tiered Cache, plus čas potřebný k navázání spojení a přijetí odpovědi z origin serverů. Toto pole nahrazuje pole OriginResponseTime.

OriginResponseHTTPExpires

Typ: string

Hodnota hlavičky 'expires' origin serveru ve formátu RFC1123.

OriginResponseHTTPLastModified

Typ: string

Hodnota hlavičky 'last-modified' origin serveru ve formátu RFC1123.

OriginResponseHeaderReceiveDurationMs

Typ: int

Doba, za kterou origin server vrátí hlavičky odpovědi poté, co Cloudflare dokončí odesílání hlaviček požadavku.

OriginResponseStatus

Typ: int

Stav vrácený upstream serverem. Hodnota 0 znamená, že od origin serveru nebyla přijata žádná odpověď a odpověď byla doručena z edge sítě Cloudflare. Pokud však na zóně běží Worker, hodnota 0 může být důsledkem dílčího požadavku Workers na origin server.

OriginResponseTime (zastaralé)

Typ: int

Počet nanosekund, které origin serveru trvalo vrátit odpověď edge serveru.

OriginSSLProtocol

Typ: string

Protokol SSL (TLS) použitý k připojení k origin serveru.

OriginTCPHandshakeDurationMs

Typ: int

Doba potřebná k dokončení TCP handshake s origin serverem. Pokud se připojení k origin serveru znovu použije, bude tato hodnota 0.

OriginTLSHandshakeDurationMs

Typ: int

Doba potřebná k dokončení TLS handshake s origin serverem. Pokud se připojení k origin serveru znovu použije, bude tato hodnota 0.

ParentRayID

Typ: string

Ray ID nadřazeného požadavku, pokud byl tento požadavek proveden pomocí Worker skriptu.

PayPerCrawlStatus

Typ: string

Výsledek Pay Per Crawl, je-li relevantní (například požadavek povolený pro zpoplatnění, který nebyl zablokován pravidlem WAF).

RayID

Typ: string

ID požadavku.

RequestHeaders

Typ: object

Řetězcové páry klíč-hodnota pro hlavičky požadavku. Toto pole se vyplňuje na základě Vlastní pole Logpush, které je třeba nakonfigurovat.

ResponseHeaders

Typ: object

Řetězcové páry klíč-hodnota pro hlavičky odpovědi. Toto pole se vyplňuje na základě Vlastní pole Logpush, které je třeba nakonfigurovat.

SecurityAction

Typ: string

Akce bezpečnostního pravidla, které případně spustilo ukončující akci.

SecurityActions

Typ: array[string]

Pole akcí, které bezpečnostní produkty Cloudflare u tohoto požadavku provedly. Konkrétní bezpečnostní produkty přiřazené k dané akci najdete v SecuritySources a jejich příslušná ID pravidel v SecurityRuleIDs. Délka pole odpovídá délce SecurityRuleIDs a SecuritySources.
Možné akce jsou unknown | Allow | Block | challenge | jschallenge | protokol | connectionClose | challengeSolved | challengeBypassed | jschallengeSolved | jschallengeBypassed | Bypass | managedChallenge | managedChallengeNonInteractiveSolved | managedChallengeInteractiveSolved | managedChallengeBypassed | přepsat | forceConnectionClose | skip | precursorInterstitialPageIssued | precursorInterstitialPageBypassed | precursorInterstitialPageSolved.

SecurityRuleDescription

Typ: string

Popis bezpečnostního pravidla, které případně vyvolalo ukončující akci.

SecurityRuleID

Typ: string

ID bezpečnostního pravidla, které případně vyvolalo ukončující akci.

SecurityRuleIDs

Typ: array[string]

Pole ID pravidel bezpečnostního produktu, která odpovídala požadavku. Bezpečnostní produkt přiřazený k danému ID pravidla najdete v SecuritySources. Délka pole odpovídá délce SecurityActions a SecuritySources.

SecuritySources

Typ: array[string]

Pole bezpečnostních produktů, které odpovídaly požadavku. Stejný produkt se může objevit vícekrát, což značí, že bylo aktivováno více pravidel nebo akcí. ID pravidel najdete v SecurityRuleIDs a akce v SecurityActions. Délka pole odpovídá délce SecurityRuleIDs a SecurityActions.
Možné zdroje jsou unknown | asn | země | ip | ipRange | securityLevel | zoneLockdown | waf | firewallRules | uaBlock | rateLimit | bic | hot | l7ddos | ověření | botFight | apiShield | botManagement | dlp | firewallManaged | firewallCustom | apiShieldSchemaValidation | apiShieldTokenValidation | apiShieldSequenceMitigation | precursor.

SmartRouteColoID

Typ: int

Datacentrum Cloudflare použité k připojení k origin serveru, pokud je použito Argo Smart Routing.

Podpožadavky

Typ: array[object]

Zploštělý seznam podpožadavků souvisejících s tímto požadavkem. Každý podpožadavek obsahuje stejná pole jako nadřazený požadavek (kromě samotného pole Subrequests).

UpperTierColoID

Typ: int

Datacentrum „vyšší úrovně“, které bylo zkontrolováno na přítomnost kopie v mezipaměti, pokud se používá Tiered Cache.

VerifiedBotCategory

Typ: string

Kategorie ověřeného bota.

WAFAttackScore

Typ: int

Celkové skóre požadavku vygenerované detekčním modulem WAF.

WAFFlags (zastaralé)

Typ: string

Další konfigurační příznaky: simulate (0x1) | null.

WAFMatchedVar (zastaralé)

Typ: string

Úplný název naposledy shodné proměnné.

WAFRCEAttackScore

Typ: int

Skóre WAF pro útok RCE.

WAFRequestSignatureCategories

Typ: array[string]

Seznam kategorií signatur útoku odpovídajících danému požadavku.

WAFRequestSignatureRefs

Typ: array[string]

Seznam odkazů na pravidla signatur útoku (refs) odpovídajících danému požadavku.

WAFSQLiAttackScore

Typ: int

Skóre WAF pro útok SQLi.

WAFXSSAttackScore

Typ: int

Skóre WAF pro útok XSS.

WebAssetsLabelsManaged

Typ: array[string]

Štítky definované Cloudflare, které odpovídají požadavku.

WebAssetsOperationID

Typ: string

UUID odpovídající operace webového aktiva.

WorkerCPUTime

Typ: int

Doba v mikrosekundách strávená spuštěním Workeru, pokud k němu došlo.

WorkerScriptName

Typ: string

Název skriptu Workeru, který požadavek vytvořil.

WorkerStatus

Typ: string

Stav vrácený z Worker daemonu.

WorkerSubrequest

Typ: bool

Zda tento požadavek byl, nebo nebyl dílčím požadavkem Workeru.

WorkerSubrequestCount

Typ: int

Počet podpožadavků vydaných Workerem při zpracování tohoto požadavku.

WorkerWallTimeUs

Typ: int

Doba v mikrosekundách mezi zahájením volání Workeru a okamžikem, kdy Workers Runtime rozhodne, že už není třeba spouštět další JavaScript. Konkrétně se tím měří reálný čas (wall-clock time), po který zůstal kontext JavaScriptu otevřený. Když se například vrací odpověď s velkým tělem, může Workers runtime v některých případech rozhodnout, že už není třeba spouštět další JavaScript, a uzavře kontext JS dříve, než všechny bajty projdou a jsou odeslány. Pokud místo toho použijete waitUntil() API pro provádění práce bez blokování vrácení odpovědi, přičemž tato práce může pokračovat i po vrácení odpovědi a bude zahrnuta v WorkerWallTimeUs.

ZoneName

Typ: string

Člověku srozumitelný název zóny (například 'cloudflare.com').