Passer au contenu principal
Utilisez l’API de destination pour enregistrer la configuration chiffrée pour Splunk, Datadog, Elastic ou un webhook HTTPS. D’abord listez les destinations : 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. Contrats de fournisseur : Splunk HEC, journaux Datadog, indexation Elasticsearch. 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 :
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 pour les instantanés d’audit enregistrés et les exportations d’événements à risque 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.