INTEGRITY Документация

HTTP-запросы

В описаниях ниже перечислены поля, доступные для http_requests.

AISecurityCustomTopicCategories

Тип: object

Определённые клиентом метки тем AI Security и их показатели релевантности. Значение 1 соответствует наивысшей релевантности, а значение 99 соответствует наименьшей релевантности.

AISecurityInjectionScore

Тип: int

Оценка вероятности атаки методом внедрения запроса (prompt injection) в этом запросе, определённая AI Security.

AISecurityPIICategories

Тип: array[string]

Список категорий PII, обнаруженных в запросе с помощью AI Security.

AISecurityTokenCount

Тип: int

Количество токенов в запросе, подсчитанное службой AI Security.

AISecurityUnsafeTopicCategories

Тип: array[string]

Список категорий небезопасных тем, обнаруженных в запросе с помощью AI Security.

BotDetectionIDs

Тип: array[int]

Список ID, соответствующих эвристическим обнаружениям Bot Management для данного запроса. Доступно только клиентам Bot Management. Чтобы включить эту функцию, обратитесь в свою команду по работе с аккаунтом.

BotDetectionTags

Тип: array[string]

Список тегов, соответствующих эвристическим обнаружениям Bot Management для данного запроса. Доступно только клиентам Bot Management. Чтобы включить эту функцию, обратитесь в свою команду по работе с аккаунтом.

BotScore

Тип: int

Cloudflare Bot Score. Оценки ниже 30 обычно связаны с автоматизированным трафиком. Доступно только клиентам Bot Management. Чтобы включить эту функцию, обратитесь в команду по работе с аккаунтом.

BotScoreSrc

Тип: string

Модуль обнаружения, отвечающий за формирование Bot Score.
Возможные значения: Не вычислено | Эвристики | Машинное обучение | Анализ поведения | Проверенный бот | JS Fingerprinting | Cloudflare Service. Доступно только для клиентов Bot Management. Чтобы включить эту функцию, обратитесь к своей команде по работе с клиентами.

BotTags

Тип: array[string]

Тип трафика ботов (если доступен). См. Теги ботов для списка возможных значений. Доступно только для клиентов Bot Management. Чтобы включить эту функцию, обратитесь в свою команду поддержки по работе с аккаунтом.

CacheCacheStatus

Тип: string

Статус кэша.
Возможные значения: unknown | miss | истёк | updating | stale | hit | ignored | Bypass | revalidated | динамический | stream_hit | deferred
«dynamic» означает, что запрос не подлежит кэшированию. Это может быть связано, например, с тем, что он был заблокирован брандмауэром. См. Кеширование ответов Cloudflare для дополнительных сведений.

CacheLockWaitedMs

Тип: int

Максимальное время ожидания блокировки кеша на всех уровнях кеша, в миллисекундах.

CacheReserveUsed

Тип: bool

Для обработки этого запроса использовался Cache Reserve.

CacheResponseBytes

Тип: int

Количество байт, возвращённых из кэша.

CacheResponseStatus (устаревшее)

Тип: int

Код состояния HTTP, возвращённый кэшем edge-серверу. Все запросы (включая те, что не подлежат кэшированию) проходят через кэш. См. также поле CacheCacheStatus.

CacheTieredFill

Тип: bool

Для обработки этого запроса использовалась функция Tiered Cache.

ClientASN

Тип: int

Номер AS клиента.

ClientCity

Тип: string

Приблизительный город клиента.

ClientCountry

Тип: string

Двухбуквенный код страны по ISO-3166 для IP-адреса клиента.

ClientDeviceType

Тип: string

Тип устройства клиента.

ClientIP

Тип: string

IP-адрес клиента.

ClientIPClass

Тип: string

Класс IP-адреса клиента.
Возможные значения: unknown | badHost | searchEngine | allowlist | monitoringService | noRecord | scan | tor.

ClientLatitude

Тип: string

Приблизительная широта клиента.

ClientLongitude

Тип: string

Приблизительная долгота клиента.

ClientMTLSAuthCertFingerprint

Тип: string

Отпечаток SHA256 сертификата, предъявленного клиентом при mTLS-аутентификации. Заполняется только для первого запроса в mTLS-соединении.

ClientMTLSAuthStatus

Тип: string

Статус аутентификации mTLS. Заполняется только для первого запроса в mTLS-соединении.
Возможные значения: unknown | ok | absent | untrusted | notyetvalid | истёк.

ClientRegionCode

Тип: string

Код региона ISO-3166-2 для IP-адреса клиента.

ClientRequestBytes

Тип: int

Количество байт в запросе клиента.

ClientRequestHost

Тип: string

Хост, запрошенный клиентом.

ClientRequestMethod

Тип: string

Метод HTTP клиентского запроса.

ClientRequestPath

Тип: string

Путь URI, запрошенный клиентом. Включает только часть пути запрошенного URL без строки запроса.

ClientRequestProtocol

Тип: string

Протокол HTTP клиентского запроса.

ClientRequestReferer

Тип: string

Referrer HTTP-запроса.

ClientRequestScheme

Тип: string

Схема URL, запрошенная посетителем.

ClientRequestSource

Тип: string

Указывает, что запрос поступил из внешнего источника или от другой службы внутри Cloudflare. См. Поле ClientRequestSource для списка возможных значений.

ClientRequestURI

Тип: string

URI, запрошенный клиентом. Включает полный путь и строку запроса запрошенного URL.

ClientRequestUserAgent

Тип: string

User agent, переданный клиентом.

ClientSSLCipher

Тип: string

Шифр SSL клиента.

ClientSSLProtocol

Тип: string

Протокол SSL (TLS) клиента. Значение «none» означает, что SSL не использовался.

ClientSrcPort

Тип: int

Исходный порт клиента.

ClientTCPRTTMs

Тип: int

Сглаженное среднее время приёма-передачи TCP (SRTT). Для первого запроса в соединении оно измеряется только во время установки соединения. Для последующих запросов в том же соединении оно измеряется за весь срок существования соединения вплоть до момента получения запроса.

ClientTLSKeyExchangeGroup

Тип: string

Группа обмена ключами TLS между клиентом и Cloudflare (например, 'X25519MLKEM768'). Значение 'UNK' означает, что определить её не удалось. Значение 'NONE' означает, что TLS не использовался.

ClientXRequestedWith

Тип: string

HTTP-заголовок X-Requested-With.

ContentScanObjResults

Тип: array[string]

Список результатов сканирования содержимого.

ContentScanObjSizes

Тип: array[int]

Список размеров объектов содержимого.

ContentScanObjTypes

Тип: array[string]

Список типов содержимого.

Cookies

Тип: object

Строковые пары ключ-значение для cookie. Это поле заполняется на основе Пользовательские поля Logpush, которые необходимо настроить.

EdgeCFConnectingO2O

Тип: bool

Значение true, если запрос прошёл через несколько зон в периферийной сети Cloudflare. Такой запрос считается запросом O2O.

EdgeColoCode

Тип: string

Код IATA аэропорта дата-центра, который принял запрос.

EdgeColoID

Тип: int

ID edge-дата-центра Cloudflare.

EdgeEndTimestamp

Тип: int or string

Временная метка момента, когда периферийная сеть завершила отправку ответа клиенту.

EdgePathingOp

Тип: string

Указывает, какой тип ответа был выдан для этого запроса (unknown = конкретное действие не выполнялось).

EdgePathingSrc

Тип: string

Показывает, как запрос был классифицирован на основе проверок безопасности (unknown = классификация не определена).

EdgePathingStatus

Тип: string

Указывает, какие данные использовались для определения способа обработки этого запроса (unknown = данных нет).

EdgeRequestHost

Тип: string

Заголовок Host в запросе с edge-сервера на origin-сервер.

EdgeResponseBodyBytes

Тип: int

Размер тела HTTP-ответа, возвращённого клиентам.

EdgeResponseBytes

Тип: int

Количество байт, возвращённых edge-сервером клиенту.

EdgeResponseCompressionRatio

Тип: float

Коэффициент сжатия ответа периферийного сервера рассчитывается как отношение размера исходного ответа к размеру сжатого.

EdgeResponseContentType

Тип: string

Значение заголовка Content-Type в ответе периферийного сервера.

EdgeResponseStatus

Тип: int

Код состояния HTTP, возвращённый клиенту Cloudflare.

EdgeServerIP

Тип: string

IP-адрес edge-сервера, выполняющего запрос к origin-серверу. Возможные значения: строка в формате IPv4 или IPv6, либо пустая строка. Пустая строка означает, что запрос к origin-серверу не выполнялся.

EdgeStartTimestamp

Тип: int or string

Временная метка момента, когда периферийная сеть получила запрос от клиента.

EdgeTimeToFirstByteMs

Тип: int

Общее представление показателя Time To First Byte, измеренного на периферийной сети Cloudflare. Отсчёт начинается после установления TCP-соединения и заканчивается, когда Cloudflare начинает возвращать конечным пользователям первый байт ответа. Включает время TLS-рукопожатия (для новых соединений) и время ответа origin-сервера.

FirewallForAIInjectionScore (устаревшее)

Тип: int

Оценка вероятности атаки методом внедрения запроса (prompt injection) в этом запросе, определённая Firewall for AI. Устарело: используйте вместо этого AISecurityInjectionScore.

FirewallForAIPIICategories (устаревшее)

Тип: array[string]

Список категорий PII, обнаруженных в запросе с помощью Firewall for AI. Устарело: используйте вместо этого AISecurityPIICategories.

FirewallForAITokenCount (устаревшее)

Тип: int

Количество токенов в запросе, подсчитанное службой Firewall for AI. Устарело: используйте вместо этого AISecurityTokenCount.

FirewallForAIUnsafeTopicCategories (устаревшее)

Тип: array[string]

Список категорий небезопасных тем, обнаруженных в запросе с помощью Firewall for AI. Устарело: используйте вместо этого AISecurityUnsafeTopicCategories.

FraudAttack

Тип: string

Основная атака или сценарий использования, обнаруженные в запросе службой Fraud detections.

FraudDetectionIDs

Тип: array[int]

Список ID, соответствующих обнаружениям мошенничества для данного запроса.

FraudDetectionTags

Тип: array[string]

Список тегов, соответствующих обнаружениям мошенничества для данного запроса.

FraudEmailRisk

Тип: string

Риск конкретного адреса электронной почты.
Возможные значения: низкий | medium | высокий.

FraudUserID

Тип: string

Уникальный идентификатор, который система Fraud Detection генерирует для каждого пользователя при любом действии, определяемом типом события мошенничества.

JA3Hash

Тип: string

Хеш MD5 отпечатка JA3, используемого для профилирования клиентов SSL/TLS. Доступен только клиентам Bot Management. Чтобы включить эту функцию, обратитесь к своей команде по работе с клиентами.

JA4

Тип: string

Отпечаток JA4, используемый для профилирования клиентов SSL/TLS. Доступен только клиентам Bot Management. Чтобы включить эту функцию, обратитесь к своей команде по работе с клиентами.

JA4Signals

Тип: object

Статистика между запросами, вычисленная для этого отпечатка JA4. Поле JA4Signals организовано в виде пар ключ:значение, где значения являются числами. Доступно только для клиентов Bot Management. Чтобы включить эту функцию, обратитесь в свою команду поддержки по работе с аккаунтом.

JSDetectionPassed

Тип: string

Прошёл ли запрос фоновую проверку JavaScript Detection.
Возможные значения: passed | failed | missing. Доступно только для клиентов Bot Management. Чтобы включить эту функцию, обратитесь к своей команде по работе с клиентами.

LeakedCredentialCheckResult

Тип: string

Результат проверки утекшие учётные данные.
Возможные результаты: password_leaked | username_and_password_leaked | username_password_similar | username_leaked | clean.

MatchedRules

Тип: array[object]

Массив сработавших правил продуктов Cloudflare Rules, сгруппированных по продукту. Каждый объект содержит: product (string, например snippets, transform, redirects), rulesetId (string), rulesetVersion (int) и правила (массив объектов, каждый из которых содержит id (string) и необязательный метаданные (объект с парами ключ-значение типа string)).

OriginDNSResponseTimeMs

Тип: int

Время, затраченное на получение DNS-ответа для имени origin-сервера. Обычно занимает несколько миллисекунд, но может быть дольше при использовании записи CNAME.

OriginIP

Тип: string

IP-адрес origin-сервера.

OriginRequestHeaderSendDurationMs

Тип: int

Время, затраченное на отправку заголовков запроса на origin-сервер после установления соединения. Обычно это значение равно 0.

OriginResponseBytes (устарело)

Тип: int

Количество байт, возвращённых origin-сервером. Рекомендуется использовать поле CacheResponseBytes и отфильтровывать значения OriginResponseStatus 0 и 304, которые указывают на повторно подтверждённый ответ. См. Расчёт байтов, отданных origin-сервером.

OriginResponseDurationMs

Тип: int

Время отклика upstream-сервера, измеренное от первого дата-центра, который получает запрос. Включает время, затраченное на Argo Smart Routing и Tiered Cache, а также время на подключение и получение ответа от origin-серверов. Это поле заменяет поле OriginResponseTime.

OriginResponseHTTPExpires

Тип: string

Значение заголовка origin-сервера 'expires' в формате RFC1123.

OriginResponseHTTPLastModified

Тип: string

Значение заголовка origin-сервера 'last-modified' в формате RFC1123.

OriginResponseHeaderReceiveDurationMs

Тип: int

Время, которое потребовалось origin-серверу, чтобы вернуть заголовки ответа после того, как Cloudflare закончил отправку заголовков запроса.

OriginResponseStatus

Тип: int

Статус, возвращённый upstream-сервером. Значение 0 означает, что ответ от origin-сервера не был получен и ответ был отдан периферийной сетью Cloudflare. Однако если в зоне работает Worker, значение 0 может быть результатом подзапроса Workers к origin-серверу.

OriginResponseTime (устарело)

Тип: int

Количество наносекунд, которое потребовалось origin-серверу, чтобы вернуть ответ edge-серверу.

OriginSSLProtocol

Тип: string

Протокол SSL (TLS), используемый для подключения к origin-серверу.

OriginTCPHandshakeDurationMs

Тип: int

Время, затраченное на установление TCP-соединения с origin-сервером. Если соединение с origin-сервером переиспользуется, значение будет равно 0.

OriginTLSHandshakeDurationMs

Тип: int

Время, затраченное на установление TLS-соединения с origin-сервером. Если соединение с origin-сервером переиспользуется, значение будет равно 0.

ParentRayID

Тип: string

Ray ID родительского запроса, если этот запрос был выполнен с помощью скрипта Worker.

PayPerCrawlStatus

Тип: string

Результат Pay Per Crawl, если применимо (например, запрос доступен для оплаты и не заблокирован правилом WAF).

RayID

Тип: string

Идентификатор запроса.

RequestHeaders

Тип: object

Строковые пары ключ-значение для заголовков запроса. Это поле заполняется на основе Пользовательские поля Logpush, которые необходимо настроить.

ResponseHeaders

Тип: object

Строковые пары ключ-значение для заголовков ответа. Это поле заполняется на основе Пользовательские поля Logpush, которые необходимо настроить.

SecurityAction

Тип: string

Действие правила безопасности, вызвавшего завершающее действие, если оно было.

SecurityActions

Тип: array[string]

Массив действий, которые продукты безопасности Cloudflare выполнили над этим запросом. Конкретные продукты безопасности, связанные с этим действием, можно найти в SecuritySources, а соответствующие ID их правил в SecurityRuleIDs. Длина массива совпадает с длиной SecurityRuleIDs и SecuritySources.
Возможные действия: unknown | allow | блокировать | проверка | jschallenge | журнал | connectionClose | challengeSolved | challengeBypassed | jschallengeSolved | jschallengeBypassed | Bypass | managedChallenge | managedChallengeNonInteractiveSolved | managedChallengeInteractiveSolved | managedChallengeBypassed | перезапись | forceConnectionClose | skip | precursorInterstitialPageIssued | precursorInterstitialPageBypassed | precursorInterstitialPageSolved.

SecurityRuleDescription

Тип: string

Описание правила безопасности, которое вызвало завершающее действие, если оно было.

SecurityRuleID

Тип: string

ID правила безопасности, вызвавшего завершающее действие, если оно было.

SecurityRuleIDs

Тип: array[string]

Массив ID правил продукта безопасности, которые сработали на запрос. Продукт безопасности, связанный с ID правила, можно найти в SecuritySources. Длина массива совпадает с длиной SecurityActions и SecuritySources.

SecuritySources

Тип: array[string]

Массив продуктов безопасности, которые сработали на запрос. Один и тот же продукт может встречаться несколько раз, что указывает на срабатывание разных правил или действий. ID правил можно найти в SecurityRuleIDs, а действия в SecurityActions. Длина массива совпадает с длиной SecurityRuleIDs и SecurityActions.
Возможные источники: unknown | asn | страна | ip | ipRange | securityLevel | zoneLockdown | waf | firewallRules | uaBlock | rateLimit | bic | hot | l7ddos | валидация | botFight | apiShield | botManagement | dlp | firewallManaged | firewallCustom | apiShieldSchemaValidation | apiShieldTokenValidation | apiShieldSequenceMitigation | precursor.

SmartRouteColoID

Тип: int

Дата-центр Cloudflare, используемый для соединения с origin-сервером, если используется Argo Smart Routing.

Подзапросы

Тип: array[object]

Плоский список подзапросов, связанных с этим запросом. Каждый подзапрос содержит те же поля, что и родительский запрос (за исключением самого поля Subrequests).

UpperTierColoID

Тип: int

Дата-центр «верхнего уровня», в котором проверялось наличие кешированной копии, если используется Tiered Cache.

VerifiedBotCategory

Тип: string

Категория верифицированного бота.

WAFAttackScore

Тип: int

Общая оценка запроса, сформированная модулем обнаружения WAF.

WAFFlags (устарело)

Тип: string

Дополнительные флаги конфигурации: simulate (0x1) | null.

WAFMatchedVar (устарело)

Тип: string

Полное имя последней найденной переменной.

WAFRCEAttackScore

Тип: int

Оценка WAF для атаки RCE.

WAFRequestSignatureCategories

Тип: array[string]

Список категорий сигнатур атак, совпавших с запросом.

WAFRequestSignatureRefs

Тип: array[string]

Список ссылок на правила сигнатур атак (refs), совпавших с запросом.

WAFSQLiAttackScore

Тип: int

Оценка WAF для атаки SQLi.

WAFXSSAttackScore

Тип: int

Оценка WAF для атаки XSS.

WebAssetsLabelsManaged

Тип: array[string]

Метки, определённые Cloudflare и соответствующие запросу.

WebAssetsOperationID

Тип: string

UUID сопоставленной операции с веб-активом.

WorkerCPUTime

Тип: int

Время в микросекундах, затраченное на выполнение Worker, если оно имело место.

WorkerScriptName

Тип: string

Имя скрипта Worker, отправившего этот запрос.

WorkerStatus

Тип: string

Статус, возвращённый демоном Worker.

WorkerSubrequest

Тип: bool

Был ли этот запрос подзапросом Worker.

WorkerSubrequestCount

Тип: int

Количество подзапросов, отправленных Worker при обработке этого запроса.

WorkerWallTimeUs

Тип: int

Время в микросекундах между началом вызова Worker и моментом, когда Workers Runtime определяет, что больше не нужно выполнять JavaScript. Точнее, это фактическое время (wall-clock time), в течение которого оставался открытым контекст JavaScript. Например, при возврате ответа с большим телом Workers Runtime в некоторых случаях может определить, что выполнять JavaScript больше не требуется, и закрыть контекст JS до того, как все байты будут переданы и отправлены. Если вместо этого вы используете waitUntil() API для выполнения работы без блокировки возврата ответа: эта работа может продолжать выполняться уже после того, как ответ был возвращён, и будет включена в WorkerWallTimeUs.

ZoneName

Тип: string

Понятное человеку имя зоны (например, 'cloudflare.com').