Saltar al contenido principal
Utilice la API de destino para guardar la configuración cifrada para Splunk, Datadog, Elastic o un webhook HTTPS. Primero liste los destinos: delivery_available debe ser true antes de habilitar la entrega. Una implementación sin el trabajador devuelve 409 DELIVERY_UNAVAILABLE cuando solicita enabled: true.

Qué se entrega

Un destino habilitado recibe nuevos eventos de auditoría cuyo espacio de trabajo y entorno fueron verificados cuando se registraron. Un destino de producción nunca recibe eventos de sandbox. Los eventos históricos y los eventos sin atribución de entorno confiable no se asignan a un entorno adivinado ni se transmiten. Esto no promete que cada productor heredado registre cada acción de la plataforma; utilice la evidencia de auditoría/exportación registrada para identificar las brechas de cobertura. La configuración no es prueba de ingesta. status: enabled significa que el destino está habilitado. La respuesta de la lista incluye delivery_counts a nivel de entorno para los registros pending, delivered, failed y cancelled. Un registro entregado ha recibido el acuse de recibo HTTP del proveedor; la indexación, las alertas y la retención posteriores también deben verificarse en su SIEM.

Configurar el receptor

Utilice un nombre de host HTTPS público en el puerto 443, sin credenciales en la URL, parámetros de consulta o fragmentos. Las direcciones privadas, las redirecciones y los endpoints no HTTPS son rechazados. Cada entorno de espacio de trabajo admite hasta 20 destinos. Contratos de proveedor: Splunk HEC, registros de Datadog, indexación de Elasticsearch. El soporte de protocolo no establece que su cuenta de proveedor haya aceptado un evento; pruebe la cuenta configurada. Suministre secret para webhooks o token para los otros proveedores, nunca ambos. Las credenciales se cifran en reposo y nunca se devuelven. Cambiar un punto final requiere proporcionar su credencial nuevamente. Utilice una credencial dedicada con privilegios de solo ingesta donde sea compatible.

Verificar firmas de webhook

La envoltura JSON incluye id, tenant_id, environment_id, occurred_at y event. El encabezado X-Truthlocks-Event-ID repite el ID del evento. Verifique los bytes exactos del cuerpo HTTP antes de analizarlos o procesarlos:
Acepte solo el espacio de trabajo/entorno esperado y registre los ID de evento de forma duradera para rechazar las repeticiones. Devuelva una respuesta 2xx solo después de aceptar el evento en el almacenamiento duradero. Utilice la comparación de firmas de tiempo constante; no registre el secreto compartido ni los encabezados de autenticación.

Reintentos y cambios de configuración

La entrega es al menos una vez. La cola se confirma en la misma transacción de base de datos que el evento de auditoría atribuido, por lo que una reversión de auditoría no puede dejar una entrega atrás. Un fallo del trabajador después de la aceptación del receptor puede causar un duplicado; deduplique usando el ID de evento estable. Los fallos de transporte y las respuestas no 2xx se reintentan con retroceso exponencial comenzando en un minuto, limitado a una hora, hasta 20 intentos. Los registros agotados permanecen failed; no hay reintento automático ilimitado ni tiempo de finalización prometido. Deshabilitar o cambiar un destino cancela sus entregas pendientes para evitar reenviar un backlog antiguo a un receptor cambiado. La eliminación elimina la configuración, la credencial guardada y sus registros de cola de entrega. Conserve la evidencia de entrega requerida antes de la eliminación. No hay una reproducción histórica automática.

Exportaciones de instantáneas

Use exportaciones de auditoría para instantáneas de auditoría registradas y exportaciones de eventos de riesgo para instantáneas de señales de riesgo admitidas. Persista la posición de procesamiento y elimine los duplicados de las identidades de eventos al importar instantáneas. Los trabajos de exportación, la entrega de SIEM y las alertas posteriores son operaciones separadas; completar una no prueba que las otras tuvieron éxito.