← Cloudflare Logs / logs / logpush / logpush-job / enable-destinations

Включите SentinelOne

HTTP Event Collector (HEC) является надёжным способом отправки данных журналов в SentinelOne Singularity Data Lake. Cloudflare Logpush поддерживает отправку журналов напрямую в SentinelOne HEC через панель управления Cloudflare или API.

1. На панели управления Cloudflare перейдите к разделу Logpush на уровне аккаунта или домена (также называемого зоной).

   Для аккаунта: Перейдите в Logpush ↗

   Для домена (также называемого зоной): Перейдите в Logpush ↗

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

3. Выберите Создание задания Logpush.

4. В Выберите пункт назначения, выберите SentinelOne.

5. Введите или выберите следующую информацию о получателе:

   • SentinelOne HEC URL
   • Auth Token - Токен Event Collector.
   • Тип источника - Например, marketplace-cloudflare-latest.

Когда вы закончите вводить данные получателя, выберите Продолжение.

6. Выберите набор данных для отправки в хранилище.

7. На следующем шаге настройте задание Logpush:

   • Введите Название задания.
   • В разделе Если журналы соответствуют, вы можете выбрать, какие события включить в журналы или исключить из них. См. Фильтры с дополнительной информацией. Эта опция доступна не для всех наборов данных.
   • В Отправьте следующие поля, вы можете либо отправлять в хранилище назначения все журналы, либо выбирать, какие журналы отправлять.

8. В Advanced Options, вы можете:

   • Выберите формат полей отметки времени в своих журналах (RFC3339 (по умолчанию), Unix, или UnixNano).
   • Выберите частота сэмплирования для ваших журналов или отправлять случайно выбранный процент журналов.
   • Включите скрытие данных для CVE-2021-44228. Эта опция заменит каждое вхождение ${ с x{.

9. Выберите Отправить после того как настройка задания Logpush завершена.

Чтобы настроить задание Logpush для SentinelOne:

1. Создайте задание, указав соответствующий URL конечной точки и параметры аутентификации.
2. Включите задание, чтобы оно начало отправлять журналы.

Убедитесь Log Share разрешения включены, прежде чем пытаться читать или настраивать задание Logpush. Дополнительные сведения см. в Раздел Roles.

Чтобы создать задание, выполните POST запрос к конечной точке заданий Logpush со следующими полями:

• имя (необязательно) - Используйте имя своего домена в качестве имени задания.
• destination_conf - Получатель журналов, состоящий из URL эндпойнта, типа источника и заголовка авторизации в формате строки ниже.
  • <SENTINELONE_ENDPOINT_URL>: URL-адрес raw HTTP Event Collector SentinelOne с портом. Например: sentinelone://ingest.us1.sentinelone.net/services/collector/raw. Cloudflare ожидает, что конечная точка SentinelOne будет /services/collector/raw при настройке и создании задания Logpush.
  • <SENTINELONE_AUTH_TOKEN>: Токен авторизации SentinelOne, закодированный в URL-формате. Например: Bearer 0e6d94e8c-5792-4ad1-be3c-29bcaee0197d.
  • <SOURCE_TYPE>: Тип источника SentinelOne. Например: marketplace-cloudflare-latest.

"https://<SENTINELONE_ENDPOINT_URL>?sourcetype=<SOURCE_TYPE>&header_Authorization=<SENTINELONE_AUTH_TOKEN>"

• dataset - Категория журналов, которые вы хотите получать. См. Наборы данных для полного списка поддерживаемых наборов данных.

• output_options (необязательно) - Чтобы настроить поля, частоту выборки и формат временной метки, см. Параметры вывода журнала. Для временной метки Cloudflare рекомендует использовать timestamps=rfc3339.

Пример запроса с использованием cURL:

curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/logpush/jobs" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"name": "<DOMAIN_NAME>",
		"destination_conf": "sentinelone://<SENTINELONE_ENDPOINT_URL>?sourcetype=<SOURCE_TYPE>&header_Authorization=<SENTINELONE_AUTH_TOKEN>",
		"output_options": {
				"field_names": [
						"ClientIP",
						"ClientRequestHost",
						"ClientRequestMethod",
						"ClientRequestURI",
						"EdgeEndTimestamp",
						"EdgeResponseBytes",
						"EdgeResponseStatus",
						"EdgeStartTimestamp",
						"RayID"
				],
				"timestamp_format": "rfc3339"
		},
		"dataset": "http_requests",
		"enabled": true
	}'

Ответ:

{
  "errors": [],
  "messages": [],
  "result": {
    "id": <JOB_ID>,
    "dataset": "http_requests",
    "kind": "",
    "enabled": true,
    "name": "<DOMAIN_NAME>",
    "output_options": {
      "field_names": ["ClientIP", "ClientRequestHost", "ClientRequestMethod", "ClientRequestURI", "EdgeEndTimestamp","EdgeResponseBytes", "EdgeResponseStatus", "EdgeStartTimestamp", "RayID"],
      "timestamp_format": "rfc3339"
    },
    "destination_conf": "sentinelone://<SENTINELONE_ENDPOINT_URL>?sourcetype=<SOURCE_TYPE>&header_Authorization=<SENTINELONE_AUTH_TOKEN>",
    "last_complete": null,
    "last_error": null,
    "error_message": null
  },
  "success": true
}

См. Управлять Logpush с помощью cURL чтобы обновить задание (включая включение и отключение).

См. Logpush (FAQ) с информацией по устранению неполадок.