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

Firewall events

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

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.

Действие

Тип: string

Код основного действия, которое Cloudflare Firewall применил к этому запросу.
Возможные действия: unknown | allow | блокировать | проверка | jschallenge | журнал | connectionclose | challengesolved | challengebypassed | jschallengesolved | jschallengebypassed | Bypass | managedchallenge | managedchallengenoninteractivesolved | managedchallengeinteractivesolved | managedchallengebypassed | precursorinterstitialpageissued | precursorinterstitialpagebypassed | precursorinterstitialpagesolved.

ClientASN

Тип: int

ASN посетителя.

ClientASNDescription

Тип: string

ASN посетителя в виде строки.

ClientCountry

Тип: string

Страна, из которой поступил запрос.

ClientIP

Тип: string

IP-адрес посетителя (IPv4 или IPv6).

ClientIPClass

Тип: string

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

ClientRefererHost

Тип: string

Хост реферера.

ClientRefererPath

Тип: string

Путь реферера, запрошенный посетителем.

ClientRefererQuery

Тип: string

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

ClientRefererScheme

Тип: string

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

ClientRequestHost

Тип: string

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

ClientRequestMethod

Тип: string

HTTP-метод, использованный посетителем.

ClientRequestPath

Тип: string

Путь, запрошенный посетителем.

ClientRequestProtocol

Тип: string

Версия протокола HTTP, запрошенная посетителем.

ClientRequestQuery

Тип: string

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

ClientRequestScheme

Тип: string

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

ClientRequestUserAgent

Тип: string

Строка User-Agent посетителя.

ContentScanObjResults

Тип: array[string]

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

ContentScanObjSizes

Тип: array[int]

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

ContentScanObjTypes

Тип: array[string]

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

Datetime

Тип: int or string

Дата и время, когда событие произошло в периферийной сети. Чтобы указать формат временной метки, см. Типы выходных данных.

Описание

Тип: string

Описание правила, которое сработало для этого запроса.

EdgeColoCode

Тип: string

Код аэропорта дата-центра Cloudflare, обработавшего этот запрос.

EdgeResponseStatus

Тип: int

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

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.

FraudUserID

Тип: string

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

Тип

Тип: string

Тип события, на данный момент допустимы только следующие значения: межсетевой экран.

LeakedCredentialCheckResult

Тип: string

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

MatchIndex

Тип: int

Порядковый номер совпадения правила в цепочке. У последнего сработавшего правила будет MatchIndex 0. Если до последнего правила сработало ещё одно, у него будет MatchIndex 1. То же самое относится к любым другим сработавшим правилам, у которых будет значение MatchIndex, равное 2, 3, и так далее.

Метаданные

Тип: object

Дополнительные сведения, специфичные для продукта. Метаданные организованы в виде пар key:value. Форматы Key и Value могут различаться в зависимости от продукта безопасности Cloudflare и со временем меняться.

OriginResponseStatus

Тип: int

Код состояния HTTP-ответа origin-сервера, возвращённый браузеру.

OriginatorRayID

Тип: string

RayID запроса, выдавшего challenge или jschallenge.

RayID

Тип: string

RayID запроса.

Ссылка

Тип: string

Определённый пользователем идентификатор правила, сработавшего на этот запрос. Используйте refs, чтобы индивидуально маркировать свои правила наряду с идентификатором RuleID, предоставляемым Cloudflare. Задать refs можно через Rulesets API для некоторых продуктов безопасности.

RuleID

Тип: string

Идентификатор правила (RuleID) конкретного продукта безопасности Cloudflare, сработавшего при обработке этого запроса.

Источник

Тип: string

Продукт безопасности Cloudflare, сработавший при обработке этого запроса.
Возможные источники: unknown | asn | страна | ip | iprange | securitylevel | zonelockdown | waf | firewallrules | uablock | ratelimit | bic | hot | l7ddos | валидация | botfight | apishield | botmanagement | dlp | firewallmanaged | firewallcustom | apishieldschemavalidation | apishieldtokenvalidation | apishieldsequencemitigation.

WAFRequestSignatureCategories

Тип: array[string]

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

WAFRequestSignatureRefs

Тип: array[string]

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

ZoneName

Тип: string

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