delivery_available deve ser true antes de habilitar a entrega. Uma implantação sem o worker retorna 409 DELIVERY_UNAVAILABLE quando você solicita enabled: true.
O que é entregue
Um destino ativado recebe novos eventos de auditoria cujo espaço de trabalho e ambiente foram verificados quando registados. Um destino de produção nunca recebe eventos de sandbox. Eventos históricos e eventos sem atribuição de ambiente fiável não são atribuídos a um ambiente adivinhado ou transmitidos. Isso não promete que cada produtor legado regista todas as ações da plataforma; use evidências de auditoria/exportação registadas para identificar lacunas de cobertura. A configuração não é prova de ingestão.status: enabled significa que o destino está habilitado. A resposta da lista inclui delivery_counts em todo o ambiente para registros pending, delivered, failed e cancelled. Um registro entregue recebeu o reconhecimento HTTP do provedor; a indexação downstream, alertas e retenção também devem ser verificados em seu SIEM.
Configurar o receptor
Use um nome de host HTTPS público na porta 443, sem credenciais na URL, parâmetros de consulta ou fragmentos. Endereços privados, redirecionamentos e endpoints não HTTPS são rejeitados. Cada ambiente de espaço de trabalho suporta até 20 destinos.
Contratos de provedor: Splunk HEC, Datadog logs, Elasticsearch indexing. O suporte ao protocolo não estabelece que sua conta de provedor aceitou um evento; teste a conta configurada.
Forneça
secret para webhooks ou token para os outros provedores, nunca ambos. As credenciais são criptografadas em repouso e nunca são retornadas. Alterar um endpoint requer o fornecimento de sua credencial novamente. Use uma credencial dedicada com privilégios apenas de ingestão onde suportado.
Verificar assinaturas de webhook
O envelope JSON incluiid, tenant_id, environment_id, occurred_at e event. O cabeçalho X-Truthlocks-Event-ID repete o ID do evento. Verifique os bytes exatos do corpo HTTP antes de analisá-los ou processá-los:
Tentativas e alterações de configuração
A entrega é de pelo menos uma vez. A fila é confirmada na mesma transação de banco de dados que o evento de auditoria atribuído, portanto, um rollback de auditoria não pode deixar uma entrega para trás. Uma falha do worker após a aceitação do receptor pode causar uma duplicata; deduplique usando o ID de evento estável. Falhas de transporte e respostas não-2xx são repetidas com backoff exponencial começando em um minuto, limitado a uma hora, até 20 tentativas. Registros esgotados permanecemfailed; não há repetição automática ilimitada ou tempo de conclusão prometido.
Desabilitar ou alterar um destino cancela suas entregas pendentes para evitar o encaminhamento de um backlog antigo para um receptor alterado. A exclusão remove a configuração, a credencial salva e seus registros de fila de entrega. Preserve as evidências de entrega necessárias antes da exclusão. Não há reprodução histórica automática.

