Экспорт аудита Sherpa AI Server в SIEM#

Отдельный контейнер отправляет новые события журнала аудита в систему сбора и анализа событий безопасности (SIEM) по протоколу Syslog. Его настраивает администратор установки с доступом к Docker Compose и PostgreSQL. Контейнер читает события приложения из таблицы orchestrator.audit. Он не собирает журнал SQL-запросов PostgreSQL.

Перед началом#

До настройки необходимо получить у технической поддержки совместимый комплект образов и Compose-файлов с контейнером aiserver-siem-exporter. Наличие установки Sherpa AI Server без этого контейнера недостаточно для выполнения инструкции.

Необходимо подготовить адрес SIEM, порт, протокол и, для TLS, доверенный сертификат. Затем создать отдельную роль PostgreSQL только для чтения:

CREATE ROLE sherpa_siem LOGIN PASSWORD '<новый пароль>';
GRANT CONNECT ON DATABASE postgres TO sherpa_siem;
GRANT USAGE ON SCHEMA orchestrator TO sherpa_siem;
GRANT SELECT ON TABLE orchestrator.audit TO sherpa_siem;

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

Штатный установщик загружает основные образы. Образ SIEM необходимо загрузить отдельно из архива той же версии. Перед загрузкой требуется проверить его контрольную сумму:

В переменной VERSION необходимо указать версию полученной поставки вместо заполнителя. Затем выполняются команды:

VERSION='<версия из комплекта>'
docker load --input "aiserver-siem-exporter_${VERSION}.tar.gz"
docker tag "aiserver-siem-exporter:${VERSION}" aiserver-siem-exporter:latest

Необходимо добавить siem к существующему значению COMPOSE_PROFILES в .env, например COMPOSE_PROFILES=gpu,siem. Тогда штатное обновление загрузит следующую версию образа.

Настройка и запуск#

Параметры получателя задаются в файле .env. После подготовки сертификатов запускается отдельный контейнер экспортера.

  1. В файле .env каталога установки необходимо указать уникальное стабильное имя установки, пароль роли и получателя:

    SIEM_INSTANCE_ID=<стабильное имя установки>
    SIEM_DB_USER=sherpa_siem
    SIEM_DB_PASSWORD=<пароль роли>
    SIEM_RECIPIENTS=[{"name":"primary","host":"siem.example.org","port":6514,"protocol":"tls"}]
    

    Для внутренней БД используются SIEM_DB_HOST=aiserver-pg, SIEM_DB_PORT=5432, SIEM_DB_NAME=postgres и SIEM_DB_SCHEMA=orchestrator. Для внешней БД необходимо заменить эти параметры в том же файле .env:

    SIEM_DB_HOST=pg.example.org
    SIEM_DB_PORT=5432
    SIEM_DB_NAME=postgres
    SIEM_DB_SCHEMA=orchestrator
    

    SIEM_DB_HOST — адрес PostgreSQL, доступный из контейнера экспортера. SIEM_DB_PORT — порт PostgreSQL. SIEM_DB_NAME — имя базы с таблицей аудита. SIEM_DB_SCHEMA — схема этой таблицы. Адрес pg.example.org необходимо заменить адресом своего сервера. Имя базы должно совпадать с GRANT CONNECT ON DATABASE postgres в SQL-командах выше. Если база или схема называются иначе, необходимо согласованно изменить параметры и команды выдачи прав, включая имя таблицы <схема>.audit.

  2. Для TLS с собственным центром сертификации необходимо подготовить каталог siem-certs в каталоге установки. В него помещаются доверенный сертификат ca.crt и, если SIEM требует взаимную аутентификацию, сертификат клиента client.crt и закрытый ключ client.key. Файлы должны быть доступны для чтения пользователю контейнера UID 10001. Закрытый ключ не следует хранить в репозитории.

    В локальный файл docker-compose.override.yml необходимо добавить монтирование, сохранив существующие настройки:

    services:
      aiserver-siem-exporter:
        volumes:
          - ./siem-certs:/etc/siem:ro
    

    Пример настройки получателя с собственным центром сертификации и mTLS в .env:

    SIEM_RECIPIENTS=[{"name":"primary","host":"siem.example.org","port":6514,"protocol":"tls","ca_file":"/etc/siem/ca.crt","cert_file":"/etc/siem/client.crt","key_file":"/etc/siem/client.key"}]
    

    Адрес и порт необходимо заменить параметрами своего SIEM. Если клиентский сертификат не требуется, необходимо убрать cert_file и key_file вместе. Для внешней БД необходимо задать SIEM_DB_SSLMODE=verify-full и SIEM_DB_SSLROOTCERT с абсолютным путем к ее корневому сертификату внутри контейнера. Сертификат БД также необходимо смонтировать только для чтения.

  3. Из каталога установки необходимо запустить контейнер и проверить журнал:

    docker compose --profile siem up -d aiserver-siem-exporter
    docker compose logs --tail=100 aiserver-siem-exporter
    

Проверка и ограничения#

На тестовом стенде необходимо создать событие входа в Sherpa AI Server и проверить его получение в SIEM. В сообщении должны быть app_name=sherpa-ai-server, event_id, время и тип события. Исходные message, diff и agent не отправляются. Контейнер не создает события, которых нет в журнале аудита приложения.

По умолчанию экспортируются только новые записи. Чтобы загрузить сохраненные записи при первом запуске, необходимо задать SIEM_START_ID=0 до запуска. У каждого получателя из SIEM_RECIPIENTS свой курсор в томе aiserver-siem-state. Имена получателей должны быть уникальны и оставаться стабильными. При обнаруженной ошибке TCP/TLS курсор получателя не продвигается. После восстановления возможны повторы с тем же event_id. Для исключения повторов необходимо настроить дедупликацию по event_id в SIEM. UDP не подтверждает доставку и допускает потерю сообщений.

Экспортер повторно просматривает уже пройденные ID и доставляет запись, которая стала видимой после более высокого ID. Обход читает ID пакетами до 10 000 за цикл. Время обнаружения зависит от объема журнала. При первом запуске режим latest отмечает уже видимые записи как обработанные и не отправляет их. Если транзакция завершится позже первоначального чтения, ее события будут доставлены даже при меньшем ID. Для загрузки уже видимых записей необходимо указать SIEM_START_ID=0. Том хранит обработанные ID и растет вместе с числом записей и получателей.

Если события не приходят, необходимо проверить журнал контейнера, адрес и порт получателя, права роли и сертификаты. Том aiserver-siem-state нельзя удалять при обычном перезапуске: это сбросит курсоры. Успешная отправка TCP/TLS подтверждает запись в соединение, но не сохранение события в SIEM.

Для выбора способа передачи в поле protocol используются следующие значения:

  • tls — передача с шифрованием и проверкой сертификата и имени сервера;
  • tcp — передача по соединению без шифрования;
  • udp — передача без подтверждения доставки.

При ошибке TLS автоматического перехода на незашифрованное соединение нет. Для получателя необходимо выбрать протокол и порт, которые поддерживает его SIEM.

Срок хранения таблицы аудита необходимо согласовать с максимальным временем недоступности получателя. События, удаленные из таблицы до отправки, экспортер восстановить не сможет. При UDP курсор продолжает продвигаться даже без доступного получателя, поэтому этот протокол подходит только при допустимой потере сообщений.

С одним томом aiserver-siem-state необходимо запускать только одну копию экспортера. Администратору требуется контролировать свободное место на томе: журнал обработанных ID растет вместе с объемом аудита и числом получателей.

Для остановки экспорта необходимо выполнить команду из каталога установки:

docker compose stop aiserver-siem-exporter

После остановки для отключения автоматического запуска необходимо также удалить siem из COMPOSE_PROFILES, сохранив остальные профили. Работа Sherpa AI Server продолжается. Том с курсорами и записи аудита сохраняются.