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

2023-02-01 - Обновления полей безопасности

Cloudflare развернёт ряд обновлений полей, связанных с безопасностью, в Cloudflare Logs. Эти обновления затронут следующие наборы данных:

Хронология

Чтобы свести к минимуму возможное влияние на существующие SIEM конфигурациях эти обновления будут выполняться в два этапа по следующему графику:

Этап 1 (February 1, 2023)

Поля журналов, которые добавляются, Cloudflare будет постепенно добавлять в наборы данных журналов.

Для переименовываемых полей журналов Cloudflare сделает следующее:

Поля журналов, которые удаляются, Cloudflare объявляет устаревшими. Их удаление из наборов данных журналов произойдёт 1 августа 2023 года.

Помимо этих изменений в Cloudflare Logs, Cloudflare также добавит новые поля, связанные с безопасностью, в следующие Наборы данных GraphQL:

Этап 2 (August 1, 2023)

Поля журналов, которые переименовываются, Cloudflare удалит в старом виде из наборов данных журналов Cloudflare. С 1 августа 2023 года будут доступны только новые поля.

Поля журналов, которые удаляются, Cloudflare также удалит из наборов данных журналов Cloudflare. С 1 августа 2023 года эти поля будут недоступны.

Основные понятия

В описаниях полей ниже используются следующие понятия:

Дополнительную информацию об этих действиях см. в Действия в документации по языку правил.

Изменения в наборе данных 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 в панели управления

  1. На панели управления Cloudflare перейдите к разделу Logpush страницу.

    Перейдите в Logpush ↗
  2. Выберите Изменить рядом с заданием Logpush, которое требуется изменить.

  3. В разделе Выбор полей данных, обновите поля в своём задании. Новые поля лога безопасности доступны в разделе Общее.

  4. Выберите 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&timestamps=rfc3339"
+   logpull_options     = "fields=RayID,ClientIP,EdgeStartTimestamp,SecurityAction&timestamps=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"
  }