← Cloudflare Logs / logs / reference / change-notices
2023-02-01 - Обновления полей безопасности
Cloudflare развернёт ряд обновлений полей, связанных с безопасностью, в Cloudflare Logs. Эти обновления затронут следующие наборы данных:
Хронология
Чтобы свести к минимуму возможное влияние на существующие SIEM конфигурациях эти обновления будут выполняться в два этапа по следующему графику:
Этап 1 (February 1, 2023)
Поля журналов, которые добавляются, Cloudflare будет постепенно добавлять в наборы данных журналов.
Для переименовываемых полей журналов Cloudflare сделает следующее:
- Добавление новых полей с теми же данными, что и поля, которые будут удалены на этапе 2 (в этом документе они называются старыми полями). Эти новые поля будут становиться доступны постепенно. Подробности см. в следующих разделах.
- Объявление об устаревании старых полей. Cloudflare удалит эти поля из наборов данных журналов 1 августа 2023 года.
Поля журналов, которые удаляются, Cloudflare объявляет устаревшими. Их удаление из наборов данных журналов произойдёт 1 августа 2023 года.
Помимо этих изменений в Cloudflare Logs, Cloudflare также добавит новые поля, связанные с безопасностью, в следующие Наборы данных GraphQL:
httpRequestsAdaptivehttpRequestsAdaptiveGroupsfirewallEventsAdaptivefirewallEventsAdaptiveGroupsfirewallEventsAdaptiveByTimeGroups
Этап 2 (August 1, 2023)
Поля журналов, которые переименовываются, Cloudflare удалит в старом виде из наборов данных журналов Cloudflare. С 1 августа 2023 года будут доступны только новые поля.
Поля журналов, которые удаляются, Cloudflare также удалит из наборов данных журналов Cloudflare. С 1 августа 2023 года эти поля будут недоступны.
Основные понятия
В описаниях полей ниже используются следующие понятия:
-
Завершающее действие: Одно из следующих действий:
blockjs_challengemanaged_challengechallenge(Interactive Challenge)
Дополнительную информацию об этих действиях см. в Действия в документации по языку правил.
-
Правило безопасности: Один из следующих типов правил:
Изменения в наборе данных HTTP Requests
Следующие поля будут переименованы в HTTP-запросы набор данных по двухэтапной стратегии, описанной в хронология:
| Новое название поля | Тип | Описание | Старое имя поля (устарело с 1 августа 2023 г.) |
|---|---|---|---|
SecurityRuleID |
String | ID правила безопасности, вызвавшего завершающее действие, если оно было. | WAFRuleID |
SecurityRuleDescription |
String | Описание правила безопасности, вызвавшего завершающее действие, если оно было. | WAFRuleMessage |
SecurityAction |
String | Действие правила безопасности, вызвавшего завершающее действие, если оно было. | WAFAction |
SecurityRuleIDs |
String Array | Массив ID правил безопасности, которые сработали на запрос. | FirewallMatchesRuleIDs |
SecurityActions |
String Array | Массив действий, которые продукты безопасности Cloudflare выполнили над запросом. | FirewallMatchesActions |
SecuritySources |
String Array | Массив продуктов безопасности Cloudflare, которые соответствовали запросу. | FirewallMatchesSources |
Следующие поля признаны устаревшими и будут удалены из набора данных HTTP Requests 1 августа 2023 года:
| Устаревшее имя поля | Примечания |
|---|---|
WAFProfile |
Используется в предыдущей версии управляемых правил WAF (теперь устарело). |
EdgeRateLimitAction |
Используется в предыдущей версии правил ограничения скорости (теперь устарело). |
EdgeRateLimitID |
Используется в предыдущей версии правил ограничения скорости (теперь устарело). |
SecurityLevel |
N/A |
Изменения набора данных Firewall Events
Следующие поля будут добавлены в Firewall Events набор данных:
| Название поля | Тип | Описание |
|---|---|---|
Description |
String | Описание правила, которое сработало для запроса. |
Ref |
String | Определённый пользователем идентификатор правила, сработавшего на этот запрос. |
Изменения в наборах данных GraphQL
Cloudflare добавит следующие поля в httpRequestsAdaptive и httpRequestsAdaptiveGroups датасеты:
| Название поля | Тип | Описание |
|---|---|---|
securityAction |
String | Действие правила безопасности, вызвавшего завершающее действие, если оно было. |
securitySource |
String | Источник правила безопасности, вызвавшего завершающее действие, если оно применялось. |
Cloudflare также добавит следующее поле в firewallEventsAdaptive, firewallEventsAdaptiveGroups, а также firewallEventsAdaptiveByTimeGroups наборы данных:
| Название поля | Тип | Описание |
|---|---|---|
description |
String | Описание правила, которое сработало для запроса. |
Эти новые поля будут добавляться постепенно.
Дополнительную информацию о доступных наборах данных см. в Наборы данных GraphQL.
Обновите свои задания Logpush и SIEM-системы
Cloudflare не станет обновлять существующие задания Logpush для использования переименованных полей. Вам нужно будет обновить задания самостоятельно, следуя инструкциям ниже.
После обновления заданий Logpush может потребоваться обновить внешние фильтры или отчёты в ваших SIEM-системах, чтобы учесть изменения полей журнала.
Обновление задания Logpush в панели управления
-
На панели управления Cloudflare перейдите к разделу Logpush страницу.
Перейдите в Logpush ↗ -
Выберите Изменить рядом с заданием Logpush, которое требуется изменить.
-
В разделе Выбор полей данных, обновите поля в своём задании. Новые поля лога безопасности доступны в разделе Общее.
-
Выберите Save changes.
Обновление задания Logpush через API
Следуйте инструкциям в Обновление output_options чтобы обновить поля в задании Logpush.
Обновление задания Logpush через Terraform
Если вы уже управляете заданиями Logpush через Terraform, обновите logpull_options в вашем существующем cloudflare_logpush_job ↗ ресурс Terraform. Например:
resource "cloudflare_logpush_job" "example_job" {
enabled = true
zone_id = "<ZONE_ID>"
name = "My-logpush-job"
- logpull_options = "fields=RayID,ClientIP,EdgeStartTimestamp,WAFAction,WAFProfile×tamps=rfc3339"
+ logpull_options = "fields=RayID,ClientIP,EdgeStartTimestamp,SecurityAction×tamps=rfc3339"
destination_conf = "r2://cloudflare-logs/http_requests/date={DATE}?account-id=${var.account_id}&access-key-id=${cloudflare_api_token.logpush_r2_token.id}&secret-access-key=${sha256(cloudflare_api_token.logpush_r2_token.value)}"
dataset = "http_requests"
}