Экспорт аудита 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. После подготовки сертификатов запускается отдельный контейнер экспортера.
В файле
.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=orchestratorSIEM_DB_HOST— адрес PostgreSQL, доступный из контейнера экспортера.SIEM_DB_PORT— порт PostgreSQL.SIEM_DB_NAME— имя базы с таблицей аудита.SIEM_DB_SCHEMA— схема этой таблицы. Адресpg.example.orgнеобходимо заменить адресом своего сервера. Имя базы должно совпадать сGRANT CONNECT ON DATABASE postgresв SQL-командах выше. Если база или схема называются иначе, необходимо согласованно изменить параметры и команды выдачи прав, включая имя таблицы<схема>.audit.Для TLS с собственным центром сертификации необходимо подготовить каталог
siem-certsв каталоге установки. В него помещаются доверенный сертификатca.crtи, если SIEM требует взаимную аутентификацию, сертификат клиентаclient.crtи закрытый ключclient.key. Файлы должны быть доступны для чтения пользователю контейнера UID10001. Закрытый ключ не следует хранить в репозитории.В локальный файл
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с абсолютным путем к ее корневому сертификату внутри контейнера. Сертификат БД также необходимо смонтировать только для чтения.Из каталога установки необходимо запустить контейнер и проверить журнал:
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 продолжается. Том с курсорами и записи аудита сохраняются.