Zum Hauptinhalt springen
Verwenden Sie die Ziel-API, um verschlüsselte Konfigurationen für Splunk, Datadog, Elastic oder einen HTTPS-Webhook zu speichern. Zuerst Ziele auflisten: delivery_available muss true sein, bevor Sie die Zustellung aktivieren. Eine Bereitstellung ohne den Worker gibt 409 DELIVERY_UNAVAILABLE zurück, wenn Sie enabled: true anfordern.

Was geliefert wird

Ein aktiviertes Ziel empfängt neue Audit-Ereignisse, deren Arbeitsbereich und Umgebung bei der Aufzeichnung verifiziert wurden. Ein Produktionsziel empfängt niemals Sandbox-Ereignisse. Historische Ereignisse und Ereignisse ohne zuverlässige Umgebungszuordnung werden keiner geratenen Umgebung zugewiesen oder gestreamt. Dies verspricht nicht, dass jeder ältere Produzent jede Plattformaktion aufzeichnet; verwenden Sie aufgezeichnete Audit-/Exportnachweise, um Abdeckungslücken zu identifizieren. Konfiguration ist kein Nachweis der Aufnahme. status: enabled bedeutet, dass das Ziel aktiviert ist. Die Listenantwort enthält umgebungsweite delivery_counts für pending, delivered, failed und cancelled Datensätze. Ein gelieferter Datensatz hat die HTTP-Bestätigung des Anbieters erhalten; nachgelagerte Indizierung, Warnungen und Aufbewahrung müssen auch in Ihrem SIEM überprüft werden.

Empfänger konfigurieren

Verwenden Sie einen öffentlichen HTTPS-Hostnamen auf Port 443, ohne Anmeldeinformationen in der URL, Abfrageparametern oder Fragmenten. Private Adressen, Weiterleitungen und Nicht-HTTPS-Endpunkte werden abgelehnt. Jede Arbeitsbereichsumgebung unterstützt bis zu 20 Ziele. Anbieterverträge: Splunk HEC, Datadog-Protokolle, Elasticsearch-Indizierung. Die Protokollunterstützung stellt nicht fest, dass Ihr Anbieterkonto ein Ereignis akzeptiert hat; testen Sie das konfigurierte Konto. Geben Sie secret für Webhooks oder token für die anderen Anbieter an, niemals beides. Anmeldeinformationen werden im Ruhezustand verschlüsselt und niemals zurückgegeben. Das Ändern eines Endpunkts erfordert die erneute Angabe seiner Anmeldeinformationen. Verwenden Sie eine dedizierte Anmeldeinformation mit nur-Ingest-Berechtigungen, wo dies unterstützt wird.

Webhook-Signaturen verifizieren

Der JSON-Umschlag enthält id, tenant_id, environment_id, occurred_at und event. Der X-Truthlocks-Event-ID Header wiederholt die Ereignis-ID. Verifizieren Sie die exakten HTTP-Body-Bytes, bevor Sie sie parsen oder verarbeiten:
Akzeptieren Sie nur den erwarteten Arbeitsbereich/die erwartete Umgebung und zeichnen Sie Ereignis-IDs dauerhaft auf, um Wiederholungen abzulehnen. Geben Sie eine 2xx-Antwort erst zurück, nachdem das Ereignis in den dauerhaften Speicher übernommen wurde. Verwenden Sie einen Signaturvergleich mit konstanter Zeit; protokollieren Sie das gemeinsame Geheimnis oder die Authentifizierungsheader nicht.

Wiederholungsversuche und Konfigurationsänderungen

Die Lieferung erfolgt mindestens einmal. Die Warteschlange wird in derselben Datenbanktransaktion wie das zugehörige Audit-Ereignis festgeschrieben, sodass ein Audit-Rollback keine Lieferung zurücklassen kann. Ein Worker-Absturz nach der Annahme durch den Empfänger kann zu einer Duplizierung führen; deduplizieren Sie mithilfe der stabilen Ereignis-ID. Transportfehler und Nicht-2xx-Antworten werden mit exponentiellem Backoff wiederholt, beginnend bei einer Minute, begrenzt auf eine Stunde, bis zu 20 Versuche. Erschöpfte Datensätze bleiben failed; es gibt keine automatische unbegrenzte Wiederholung oder zugesicherte Abschlusszeit. Das Deaktivieren oder Ändern eines Ziels bricht ausstehende Lieferungen ab, um die Weiterleitung eines alten Rückstands an einen geänderten Empfänger zu vermeiden. Das Löschen entfernt die Konfiguration, die gespeicherten Anmeldeinformationen und die zugehörigen Lieferwarteschlangen-Datensätze. Bewahren Sie erforderliche Liefernachweise vor dem Löschen auf. Es gibt keine automatische historische Wiedergabe.

Snapshot-Exporte

Verwenden Sie Audit-Exporte für aufgezeichnete Audit-Snapshots und Risikoereignis-Exporte für unterstützte Risikosignal-Snapshots. Behalten Sie die Verarbeitungsposition bei und deduplizieren Sie Ereignisidentitäten beim Importieren von Snapshots. Exportaufträge, SIEM-Zustellung und nachgeschaltete Alarmierung sind separate Operationen; der Abschluss einer Operation beweist nicht den Erfolg der anderen.