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

# SIEM-Audit-Zustellung

> Konfigurieren Sie die bereichsbezogene Audit-Bereitstellung, überprüfen Sie Webhooks und verstehen Sie Abdeckung und Wiederholungsversuche.

Verwenden Sie die [Ziel-API](https://docs.truthlocks.com/de/api-reference/audit/siem/create.md), um verschlüsselte Konfigurationen für Splunk, Datadog, Elastic oder einen HTTPS-Webhook zu speichern. Zuerst [Ziele auflisten](https://docs.truthlocks.com/de/api-reference/audit/siem/list.md): `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.

| Anbieter | Endpunkt | Anmeldeinformationen und Lieferung |
| - | - | - |
| Webhook | Ihre HTTPS-Aufnahme-URL | Geben Sie `secret` an. Empfängt einen JSON-Umschlag und eine zeitgestempelte HMAC-SHA256-Signatur. |
| Splunk | HTTPS HEC Ereignisendpunkt, normalerweise `/services/collector/event` | Geben Sie einen HEC `token` an. Verwendet `Authorization: Splunk …`; HTTP-Erfolg muss auch `code: 0` enthalten. Verwenden Sie Port 443 oder einen geeigneten HTTPS-Reverse-Proxy. |
| Datadog | Der HTTPS `/api/v2/logs` Endpunkt Ihrer Website | Geben Sie einen Log-Ingestion-API-Schlüssel `token` an. Verwendet `DD-API-KEY` und ein JSON-Log-Array. Wählen Sie die richtige Datadog-Site aus. |
| Elastic | Ihr HTTPS-Endpunkt, der auf `/INDEX/_doc` endet | Geben Sie den kodierten API-Schlüssel `token` an. Verwendet `Authorization: ApiKey …` und eine deterministische Dokument-ID. |

Anbieterverträge: [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-Protokolle](https://docs.datadoghq.com/api/latest/logs/), [Elasticsearch-Indizierung](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-index). 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:

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

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](https://docs.truthlocks.com/de/api-reference/audit/export.md) für aufgezeichnete Audit-Snapshots und [Risikoereignis-Exporte](https://docs.truthlocks.com/de/api-reference/risk/exports/create.md) 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.


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