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ältid, 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:
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 bleibenfailed; 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.

