> ## 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.

# Livraison d'audit SIEM

> Configurez la livraison d'audit ciblée, vérifiez les webhooks et comprenez la couverture et les tentatives.

Utilisez l'[API de destination](https://docs.truthlocks.com/fr/api-reference/audit/siem/create.md) pour enregistrer la configuration chiffrée pour Splunk, Datadog, Elastic ou un webhook HTTPS. D'abord [listez les destinations](https://docs.truthlocks.com/fr/api-reference/audit/siem/list.md) : `delivery_available` doit être `true` avant d'activer la livraison. Un déploiement sans le travailleur renvoie `409 DELIVERY_UNAVAILABLE` lorsque vous demandez `enabled: true`.

## Ce qui est livré

Une destination activée reçoit **de nouveaux événements d'audit dont l'espace de travail et l'environnement ont été vérifiés lors de l'enregistrement**. Une destination de production ne reçoit jamais d'événements de bac à sable. Les événements historiques et les événements sans attribution d'environnement fiable ne sont pas affectés à un environnement deviné ni diffusés. Cela ne promet pas que chaque producteur hérité enregistre chaque action de la plateforme ; utilisez les preuves d'audit/exportation enregistrées pour identifier les lacunes de couverture.

La configuration n'est pas une preuve d'ingestion. `status: enabled` signifie que la destination est activée. La réponse de la liste inclut les `delivery_counts` à l'échelle de l'environnement pour les enregistrements `pending`, `delivered`, `failed` et `cancelled`. Un enregistrement livré a reçu l'accusé de réception HTTP du fournisseur ; l'indexation en aval, les alertes et la rétention doivent également être vérifiées dans votre SIEM.

## Configurer le récepteur

Utilisez un nom d'hôte HTTPS public sur le port 443, sans identifiants dans l'URL, les paramètres de requête ou les fragments. Les adresses privées, les redirections et les points de terminaison non-HTTPS sont rejetés. Chaque environnement d'espace de travail prend en charge jusqu'à 20 destinations.

| Fournisseur | Point de terminaison | Informations d'identification et livraison |
| - | - | - |
| Webhook | Votre URL d'ingestion HTTPS | Fournir `secret`. Reçoit une enveloppe JSON et une signature HMAC-SHA256 horodatée. |
| Splunk | Point de terminaison d'événement HEC HTTPS, normalement `/services/collector/event` | Fournissez un HEC `token`. Utilise `Authorization: Splunk …` ; le succès HTTP doit également contenir `code: 0`. Utilisez le port 443 ou un proxy inverse HTTPS approprié. |
| Datadog | Point de terminaison HTTPS `/api/v2/logs` de votre site | Fournir une clé API d'ingestion de journaux `token`. Utilise `DD-API-KEY` et un tableau de journaux JSON. Sélectionner le site Datadog correct. |
| Élastique | Votre point de terminaison HTTPS se terminant par `/INDEX/_doc` | Fournissez la clé API encodée `token`. Utilise `Authorization: ApiKey …` et un ID de document déterministe. |

Contrats de fournisseur : [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), [journaux Datadog](https://docs.datadoghq.com/api/latest/logs/), [indexation Elasticsearch](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-index). Le support du protocole n'établit pas que votre compte fournisseur a accepté un événement ; testez le compte configuré.

Fournissez `secret` pour les webhooks ou `token` pour les autres fournisseurs, jamais les deux. Les identifiants sont chiffrés au repos et ne sont jamais renvoyés. Changer un point de terminaison nécessite de fournir à nouveau ses identifiants. Utilisez un identifiant dédié avec des privilèges d'ingestion uniquement là où c'est pris en charge.

## Vérifier les signatures de webhook

L'enveloppe JSON inclut `id`, `tenant_id`, `environment_id`, `occurred_at` et `event`. L'en-tête `X-Truthlocks-Event-ID` répète l'ID d'événement. Vérifiez les octets exacts du corps HTTP avant de les analyser ou de les traiter :

```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", "")
    )
```

Acceptez uniquement l'espace de travail/environnement attendu et enregistrez durablement les ID d'événement pour rejeter les relectures. Ne renvoyez une réponse 2xx qu'après avoir accepté l'événement dans le stockage durable. Utilisez une comparaison de signature à temps constant ; ne journalisez pas le secret partagé ou les en-têtes d'authentification.

## Nouvelles tentatives et modifications de configuration

La livraison est au moins une fois. La file d'attente est validée dans la même transaction de base de données que l'événement d'audit attribué, de sorte qu'une annulation d'audit ne peut pas laisser une livraison derrière. Un crash du travailleur après l'acceptation du récepteur peut provoquer un doublon ; dédupliquez en utilisant l'ID d'événement stable. Les échecs de transport et les réponses non-2xx sont réessayés avec un backoff exponentiel commençant à une minute, plafonné à une heure, jusqu'à 20 tentatives. Les enregistrements épuisés restent `failed` ; il n'y a pas de nouvelle tentative illimitée automatique ni de délai d'achèvement promis.

La désactivation ou la modification d'une destination annule ses livraisons en attente pour éviter de transférer un ancien arriéré à un récepteur modifié. La suppression supprime la configuration, les identifiants enregistrés et ses enregistrements de file d'attente de livraison. Conservez les preuves de livraison requises avant la suppression. Il n'y a pas de relecture historique automatique.

## Exportations d'instantanés

Utilisez les [exportations d'audit](https://docs.truthlocks.com/fr/api-reference/audit/export.md) pour les instantanés d'audit enregistrés et les [exportations d'événements à risque](https://docs.truthlocks.com/fr/api-reference/risk/exports/create.md) pour les instantanés de signaux de risque pris en charge. Persistez la position de traitement et dédupliquez les identités d'événements lors de l'importation d'instantanés. Les tâches d'exportation, la livraison SIEM et l'alerte en aval sont des opérations distinctes ; l'achèvement de l'une ne prouve pas le succès des autres.


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