Перейти к содержанию

IBM QRadar через Logstash

Обзор примера

Вебхуки могут использоваться как один из источников логов в системе. Общее количество подобных источников зависит от сложности системы: чем больше компонентов в системе, тем больше количество источников и объем логов. Наиболее распространенная схема логирования в сложных системах состоит из компонентов:

  • Сборщик логов: принимает логи от нескольких источников и выгружает логи в SIEM-систему.

  • SIEM-система: используется для анализа логов и мониторинга состояния системы.

В приведенном примере уведомления о событиях отправляются через вебхуки в сборщик логов Logstash и выгружаются в SIEM‑систему QRadar.

Движение вебхука

Используемые ресурсы

Настройка Logstash

Настройка Logstash описана в конфигурационном файле logstash-sample.conf:

  • Обработка входящих вебхуков настроена в секции input:

    • Весь HTTP и HTTPS‑трафик поступает на порт Logstash 5044
    • SSL‑сертификат для HTTPS‑подключения расположен в файле /etc/pki/ca.pem
  • Отправка логов в QRadar и вывод логов настроены в секции output:

    • Логи всех событий из Logstash отправляются в QRadar по IP‑адресу https://109.111.35.11:514
    • Логи из Logstash в QRadar отправляются в формате JSON по стандарту Syslog
    • Соединение с QRadar выполняется по протоколу TCP
    • Логи Logstash дополнительно выводятся в командную строку (15 строка кода). Настройка используется для проверки, что события записываются в логи Logstash
input {
  http { # input‑плагин для HTTP и HTTPS‑трафика
    port => 5044 # порт для входящих запросов
    ssl => true # обработка HTTPS‑трафика
    ssl_certificate => "/etc/pki/ca.pem" # сертификат для HTTPS‑подключения
  }
}
output {
  syslog { # output‑плагин для отправки логов из Logstash по стандарту Syslog
    host => "109.111.35.11" # IP‑адрес, на который отправляются логи
    port => "514" # порт, на который отправляются логи
    protocol => "tcp" # протокол соединения
    codec => json # формат отправки логов
  }
  stdout {} # output‑плагин для вывода логов Logstash в командную строку
}

Более подробное описание конфигурационного файла доступно в официальной документации Logstash.

Тестирование настроек Logstash

Чтобы протестировать запись логов в Logstash и выгрузку данных в QRadar, можно отправить POST‑запрос в Logstash.

Пример запроса:

curl -X POST 'https://logstash.example.domain.com' -H "Content-Type: application/json" -d '{"key1":"value1", "key2":"value2"}'

Логи Logstash:

Логи Logstash

Логи QRadar:

Логи QRadar

Payload лога в QRadar:

Логи QRadar

Настройка QRadar (опционально)

На стороне QRadar выполнена настройка источника логов. Это позволяет отличать логи Logstash от остального списка логов в QRadar, а также может использоваться для дальнейшей сортировки логов. Источник логов настроен следующим образом:

  • Log Source Name: название источника логов Logstash

  • Log Source Description: описание источника логов Logs from Logstash

  • Log Source Type: тип парсера для входящих логов Universal LEEF, используется для стандарта Syslog

  • Protocol Configuration: стандарт передачи логов Syslog

  • Log Source Identifier: идентификатор источника логов, используется IP‑адрес Logstash

  • Остальные настройки по умолчанию

Более подробная информация о настройке источника логов в QRadar доступна в официальной документации IBM.

Настройка источника логов Logstash в QRadar

Настройка webhook‑интеграции

  • Вебхуки отправляются на https://logstash.example.domain.com

  • Для отправки вебхуков используются запросы типа POST

  • В запросе передается дополнительный параметр аутентификации X-Auth-Token

  • Вебхуки отправляют на Webhook URL все доступные события: хиты, системные события, уязвимости, изменения сетевого периметра

Webhook-интеграция с Logstash

Тестирование примера

Для тестирования настроек в Консоли управления Валарм добавляется новый пользователь:

Добавление пользователя

В логах Logstash появится запись:

Запись о новом пользователе в логах Logstash

В payload лога в QRadar отобразится лог Logstash:

Карточка о новом пользователе Logstash в QRadar