Exportación de la auditoría de Sherpa AI Server a un SIEM#
Un contenedor independiente envía los eventos nuevos del registro de auditoría a un sistema de gestión y análisis de eventos de seguridad (SIEM) mediante Syslog. Lo configura un administrador con acceso a Docker Compose y PostgreSQL. El contenedor lee los eventos de la aplicación de orchestrator.audit. No recopila los registros de consultas SQL de PostgreSQL.
Antes de empezar#
Antes de configurar, obtenga del soporte técnico un conjunto compatible de imágenes y archivos Compose que incluya aiserver-siem-exporter. Una instalación de Sherpa AI Server sin este contenedor no basta para seguir las instrucciones.
Prepare la dirección, el puerto y el protocolo del SIEM y, para TLS, un certificado de confianza. Cree un rol de PostgreSQL independiente de solo lectura:
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;
Sustituya la contraseña y el nombre de la base de datos por los de su instalación. No use el rol postgres ni la cuenta de la aplicación.
El instalador estándar carga las imágenes principales. Cargue la imagen opcional de SIEM por separado desde un archivo de la misma versión. Compruebe su suma de verificación antes de cargarla:
Sustituya el marcador de VERSION por la versión del paquete recibido y ejecute los comandos:
VERSION='<версия из комплекта>'
docker load --input "aiserver-siem-exporter_${VERSION}.tar.gz"
docker tag "aiserver-siem-exporter:${VERSION}" aiserver-siem-exporter:latest
Añada siem al valor existente de COMPOSE_PROFILES en .env, por ejemplo COMPOSE_PROFILES=gpu,siem. Así, el actualizador estándar cargará la siguiente versión de la imagen.
Configuración e inicio#
Los parámetros del destinatario se configuran en .env. Después de preparar los certificados, se inicia el contenedor independiente del exportador.
En el archivo
.envdel directorio de instalación, indique un nombre estable y único para la instalación, la contraseña del rol y un destinatario:SIEM_INSTANCE_ID=<стабильное имя установки> SIEM_DB_USER=sherpa_siem SIEM_DB_PASSWORD=<пароль роли> SIEM_RECIPIENTS=[{"name":"primary","host":"siem.example.org","port":6514,"protocol":"tls"}]La base interna utiliza
SIEM_DB_HOST=aiserver-pg,SIEM_DB_PORT=5432,SIEM_DB_NAME=postgresySIEM_DB_SCHEMA=orchestrator. Para una base externa, establezca estos parámetros en el mismo archivo.env:SIEM_DB_HOST=pg.example.org SIEM_DB_PORT=5432 SIEM_DB_NAME=postgres SIEM_DB_SCHEMA=orchestratorSIEM_DB_HOSTes la dirección de PostgreSQL accesible desde el contenedor del exportador.SIEM_DB_PORTes su puerto.SIEM_DB_NAMEindica la base que contiene la tabla de auditoría.SIEM_DB_SCHEMAindica su esquema. Sustituyapg.example.orgpor la dirección de su servidor. El nombre de la base debe coincidir conGRANT CONNECT ON DATABASE postgresen el SQL anterior. Si la base o el esquema tienen otro nombre, actualice tanto los parámetros como los comandos de permisos, incluido el nombre de tabla<esquema>.audit.Para TLS con una CA privada, prepare un directorio
siem-certsen el directorio de instalación. Coloque allí el certificado de confianzaca.crty, si el SIEM requiere autenticación mutua, el certificado de clienteclient.crty la clave privadaclient.key. El usuario del contenedor con UID10001debe poder leer los archivos. No guarde la clave privada en el repositorio.Añada el montaje al archivo local
docker-compose.override.yml, conservando los ajustes existentes:services: aiserver-siem-exporter: volumes: - ./siem-certs:/etc/siem:roEjemplo de configuración del destinatario con una CA privada y mTLS en
.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"}]Sustituya la dirección y el puerto por los parámetros de su SIEM. Si no se requiere un certificado de cliente, elimine juntos
cert_fileykey_file. Para una base de datos externa, configureSIEM_DB_SSLMODE=verify-fullySIEM_DB_SSLROOTCERTcon la ruta absoluta de su certificado raíz dentro del contenedor. También es necesario montar el certificado de la base de datos en modo de solo lectura.Inicie el contenedor desde el directorio de instalación y revise su registro:
docker compose --profile siem up -d aiserver-siem-exporter docker compose logs --tail=100 aiserver-siem-exporter
Comprobación y limitaciones#
Genere un evento de inicio de sesión de prueba en Sherpa AI Server y compruebe que el SIEM lo reciba. El mensaje debe contener app_name=sherpa-ai-server, event_id, la hora y el tipo de evento. No se envían los campos originales message, diff ni agent. El contenedor no crea eventos ausentes del registro de auditoría de la aplicación.
De forma predeterminada, solo se exportan registros nuevos. Para cargar registros almacenados en el primer inicio, configure SIEM_START_ID=0 antes de iniciar. Cada destinatario de SIEM_RECIPIENTS tiene su propio cursor en el volumen aiserver-siem-state. Los nombres deben ser únicos y estables. Si se detecta un error TCP/TLS, el cursor de ese destinatario no avanza. Tras la recuperación puede repetirse un evento con el mismo event_id: configure la deduplicación en el SIEM. UDP no confirma la entrega y puede perder mensajes.
El exportador vuelve a revisar los ID anteriores y entrega los registros que aparecen después de un ID superior. La revisión lee hasta 10 000 ID por ciclo. El tiempo de detección depende del tamaño del registro. En el primer inicio, latest marca los registros visibles en una instantánea de PostgreSQL sin enviarlos. Las transacciones confirmadas después se entregan aunque tengan un ID menor. Use SIEM_START_ID=0 para cargar los registros ya visibles. El volumen guarda los ID procesados y crece con los registros y destinatarios.
Si no llegan eventos, revise el registro del contenedor, la dirección y el puerto del destinatario, los permisos del rol y los certificados. No elimine el volumen aiserver-siem-state en un reinicio normal, ya que se restablecerían los cursores. El envío correcto por TCP/TLS confirma la escritura en la conexión, no el almacenamiento en el SIEM.
El campo protocol admite los siguientes medios de transporte:
tls— entrega cifrada con comprobación del certificado y del nombre del servidor;tcp— entrega mediante una conexión sin cifrado;udp— entrega sin confirmación.
Un error TLS no provoca el cambio automático a una conexión sin cifrar. Es necesario seleccionar un protocolo y un puerto compatibles con el SIEM destinatario.
La retención de la tabla de auditoría debe cubrir el tiempo máximo de indisponibilidad del destinatario. El exportador no puede recuperar eventos eliminados de la tabla antes de enviarlos. Con UDP, el cursor sigue avanzando aunque el destinatario no esté disponible. Por ello, solo se debe usar cuando la pérdida de mensajes sea aceptable.
Solo debe ejecutarse una instancia del exportador con el mismo volumen aiserver-siem-state. El administrador debe controlar el espacio libre: el registro de ID procesados crece con el volumen de auditoría y el número de destinatarios.
Para detener la exportación, ejecute desde el directorio de instalación:
docker compose stop aiserver-siem-exporter
Después, elimine también siem de COMPOSE_PROFILES para desactivar el inicio automático, conservando los otros perfiles. Sherpa AI Server seguirá funcionando. Se conservan el volumen de cursores y los registros de auditoría.