Saltar para o conteúdo principal
Use a API de destino para salvar a configuração criptografada para Splunk, Datadog, Elastic ou um webhook HTTPS. Primeiro liste os destinos: 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 inclui id, 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:
Aceite apenas o espaço de trabalho/ambiente esperado e registre os IDs de evento de forma durável para rejeitar repetições. Retorne uma resposta 2xx somente após aceitar o evento no armazenamento durável. Use comparação de assinatura de tempo constante; não registre o segredo compartilhado ou os cabeçalhos de autenticação.

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 permanecem failed; 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.

Exportações de snapshot

Use exportações de auditoria para instantâneos de auditoria registrados e exportações de eventos de risco para instantâneos de sinal de risco suportados. Persista a posição de processamento e deduplique as identidades de eventos ao importar instantâneos. Trabalhos de exportação, entrega SIEM e alertas downstream são operações separadas; completar uma não prova que as outras foram bem-sucedidas.