Saltar al contenido principal
POST
Crear destino SIEM
Verifique delivery_available en la respuesta de la lista antes de habilitar un destino. La entrega cubre nuevos eventos de auditoría con atribución de entorno verificada. Los eventos históricos y no atribuidos no se transmiten. Un destino enabled no es evidencia de una ingesta exitosa; inspeccione delivery_counts y su receptor.
Utilice la clave de API para el entorno de sandbox o producción deseado. La lista requiere audit:read; los cambios requieren audit:write. Una sesión de navegador debe pertenecer a un administrador del espacio de trabajo. Un destino de otro inquilino o entorno no puede ser actualizado o eliminado. Las credenciales se cifran en reposo y nunca aparecen en las respuestas. Para webhooks, proporcione secret; para Splunk, Datadog o Elastic, proporcione token. Cambiar un endpoint requiere proporcionar sus credenciales nuevamente. La configuración de CloudWatch no es compatible. Un entorno puede contener hasta 20 destinos. La eliminación de un destino elimina su credencial guardada y los registros de entrega en cola. Deshabilitar o cambiar un destino cancela sus entregas pendientes; guarde cualquier evidencia de entrega que necesite primero. Consulte la guía de entrega de SIEM para reintentos, configuraciones de proveedor y verificación de webhook. Para la ingesta de instantáneas, utilice exportaciones de auditoría o exportaciones de eventos de riesgo. Estas exportaciones no permiten la transmisión continua.

Autorizaciones

X-API-Key
string
header
requerido

Clave API para autenticación máquina a máquina

Cuerpo

application/json
provider
enum<string>
requerido

Tipo de proveedor SIEM.

Opciones disponibles:
splunk,
datadog,
elastic,
webhook
endpoint
string<uri>
requerido

Nombre de host HTTPS público en el puerto 443, sin credenciales de usuario, parámetros de consulta o fragmento. Cambiar el endpoint requiere proporcionar la credencial nuevamente. Guardar no valida la propiedad o la entrega.

Maximum string length: 2048
token
string
write-only

Token para la configuración de Splunk, Datadog o Elastic. Requerido en la creación para estos proveedores. No proporcione también el secreto.

Required string length: 16 - 8192
secret
string
write-only

Secreto compartido para la configuración del webhook. Requerido en la creación para el webhook. No proporcione también el token.

Required string length: 16 - 8192
enabled
boolean
predeterminado:false

Habilita la entrega de eventos de auditoría recién registrados atribuidos al entorno. Requiere delivery_available=true; de lo contrario, true devuelve 409. El valor predeterminado es false al crear un destino.

Respuesta

Destino SIEM creado.

id
string<uuid>
environment_id
string<uuid>
provider
enum<string>
Opciones disponibles:
splunk,
datadog,
elastic,
webhook
endpoint
string<uri>
enabled
boolean
status
enum<string>
Opciones disponibles:
configured_delivery_unavailable,
disabled,
enabled
credential_configured
boolean
created_at
string<date-time>
updated_at
string<date-time>