> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Entrega de auditoria SIEM

> Configure a entrega de auditoria com escopo, verifique webhooks e entenda a cobertura e as tentativas.

Use a [API de destino](https://docs.truthlocks.com/pt/api-reference/audit/siem/create.md) para salvar a configuração criptografada para Splunk, Datadog, Elastic ou um webhook HTTPS. Primeiro [liste os destinos](https://docs.truthlocks.com/pt/api-reference/audit/siem/list.md): `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.

| Provedor | Endpoint | Credencial e entrega |
| - | - | - |
| Webhook | Sua URL de ingestão HTTPS | Forneça `secret`. Recebe um envelope JSON e uma assinatura HMAC-SHA256 com carimbo de data/hora. |
| Splunk | Endpoint de evento HTTPS HEC, normalmente `/services/collector/event` | Forneça um `token` HEC. Usa `Authorization: Splunk …`; o sucesso HTTP também deve conter `code: 0`. Use a porta 443 ou um proxy reverso HTTPS apropriado. |
| Datadog | Endpoint HTTPS `/api/v2/logs` do seu site | Forneça uma chave de API de ingestão de log `token`. Usa `DD-API-KEY` e um array de log JSON. Selecione o site Datadog correto. |
| Elastic | Seu endpoint HTTPS terminando em `/INDEX/_doc` | Forneça a chave de API codificada `token`. Usa `Authorization: ApiKey …` e um ID de documento determinístico. |

Contratos de provedor: [Splunk HEC](https://help.splunk.com/splunk-enterprise/get-data-in/get-started-with-getting-data-in/9.1/get-data-with-http-event-collector/format-events-for-http-event-collector), [Datadog logs](https://docs.datadoghq.com/api/latest/logs/), [Elasticsearch indexing](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-index). 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:

```python theme={null}
import hashlib
import hmac
import time


def verify_webhook(raw_body: bytes, headers, secret: bytes) -> bool:
    timestamp = headers.get("X-Truthlocks-Timestamp", "")
    try:
        if abs(time.time() - int(timestamp)) > 300:
            return False
        signed = timestamp.encode("ascii") + b"." + raw_body
    except (ValueError, TypeError, UnicodeEncodeError):
        return False
    expected = "v1=" + hmac.new(secret, signed, hashlib.sha256).hexdigest()
    return hmac.compare_digest(
        expected, headers.get("X-Truthlocks-Signature", "")
    )
```

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](https://docs.truthlocks.com/pt/api-reference/audit/export.md) para instantâneos de auditoria registrados e [exportações de eventos de risco](https://docs.truthlocks.com/pt/api-reference/risk/exports/create.md) 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.