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 incluyeid, 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:
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 permanecenfailed; 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.

