> ## 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-Ziel erstellen

> Verwalten Sie geschützte, umgebungsbezogene Audit-Zustellungsziele.

> [!NOTE]
>
> Überprüfen Sie `delivery_available` in der Listenantwort, bevor Sie ein Ziel aktivieren. Die Zustellung umfasst neue Audit-Ereignisse mit verifizierter Umgebungszuordnung. Historische und nicht zugeordnete Ereignisse werden nicht gestreamt. Ein `enabled`-Ziel ist kein Beweis für eine erfolgreiche Aufnahme; überprüfen Sie `delivery_counts` und Ihren Empfänger.

Verwenden Sie den API-Schlüssel für die vorgesehene Sandbox- oder Produktionsumgebung. Das Auflisten erfordert `audit:read`; Änderungen erfordern `audit:write`. Eine Browsersitzung muss einem Arbeitsbereichs-Administrator gehören. Ein Ziel von einem anderen Mandanten oder einer anderen Umgebung kann nicht aktualisiert oder gelöscht werden.

Anmeldeinformationen werden im Ruhezustand verschlüsselt und erscheinen niemals in Antworten. Für Webhooks geben Sie `secret` an; für Splunk, Datadog oder Elastic geben Sie `token` an. Das Ändern eines Endpunkts erfordert die erneute Angabe seiner Anmeldeinformationen. Die CloudWatch-Konfiguration wird nicht unterstützt.

Eine Umgebung kann bis zu 20 Ziele aufnehmen. Das Löschen eines Ziels entfernt dessen gespeicherte Anmeldeinformationen und in der Warteschlange befindliche Zustellungsdatensätze. Das Deaktivieren oder Ändern eines Ziels bricht ausstehende Zustellungen ab; speichern Sie zuerst alle benötigten Zustellungsnachweise.

Informationen zu Wiederholungsversuchen, Anbietereinstellungen und Webhook-Verifizierung finden Sie im [SIEM-Bereitstellungshandbuch](https://docs.truthlocks.com/de/guides/siem-integration.md). Für die Snapshot-Aufnahme verwenden Sie [Audit-Exporte](https://docs.truthlocks.com/de/api-reference/audit/export.md) oder [Risikoereignis-Exporte](https://docs.truthlocks.com/de/api-reference/risk/exports/create.md). Diese Exporte ermöglichen kein kontinuierliches Streaming.


## OpenAPI

````yaml de/mint-openapi.yaml POST /v1/audit/siem
openapi: 3.0.3
info:
  title: Truthlocks API
  description: >
    Truthlocks ist eine universelle Verifizierungsinfrastruktur für Dokumente,
    Anmeldeinformationen und digitale Assets.

    Diese Spezifikation definiert die kanonische API für die Interaktion mit
    Truthlocks-Diensten.


    ## Basis-URLs

    - **Produktion**: `https://api.truthlocks.com`

    - **Sandbox**: `https://sandbox-api.truthlocks.com`


    ## Authentifizierung

    - **API-Schlüssel**: Verwenden Sie den Header `X-API-Key` für
    Machine-to-Machine-Operationen

    - **Bearer Tokens**: Verwenden Sie `Authorization: Bearer <jwt>` für
    benutzerinitiierte Operationen


    ## Mandantenidentität

    In der Produktion wird die Mandantenidentität aus dem authentifizierten
    Kontext (API-Schlüssel oder JWT) abgeleitet.

    Der Header `X-Tenant-ID` wird in der Produktion ignoriert, um Spoofing zu
    verhindern.
  version: 1.0.0
  contact:
    name: Truthlocks Support
    url: https://truthlocks.com/support
    email: support@truthlocks.com
servers:
  - url: https://api.truthlocks.com
    description: Produktions-API
  - url: https://sandbox-api.truthlocks.com
    description: Sandbox-Umgebung
security:
  - APIKey: []
  - BearerAuth: []
tags:
  - name: Authentication
    description: API-Schlüssel- und Token-Verwaltung
  - name: Issuers
    description: Ausstellerregistrierung und Vertrauensmanagement
  - name: Keys
    description: Kryptographische Schlüsselverwaltung für Aussteller
  - name: Attestations
    description: Bestätigungslebenszyklus (prägen, widerrufen, ersetzen)
  - name: Verification
    description: Bestätigungsverifizierung und Proof-Bundles
  - name: Governance
    description: Aussteller-Governance-Workflows (nur Admin)
  - name: Identity
    description: Organisations-, Benutzer- und Rollenverwaltung
  - name: Audit
    description: Audit-Ereignisabfragen
  - name: Tenant Console
    description: Mandantenprofil- und Lebenszyklus-Endpunkte
  - name: Health
    description: Endpunkte für Dienststatus und Bereitschaft
  - name: Risk
    description: Erfassung von Risikosignalen und Betrugserkennung
  - name: Risk Enforcement
    description: >-
      Risikodurchsetzungsmaßnahmen – Blockieren, Herausfordern, Quarantäne und
      Konfiguration
  - name: Billing
    description: Verwaltung von Abrechnung, Abonnements und Add-ons
  - name: Machine Identity
    description: >-
      Machine Agent Identity Protocol (MAIP) – Agentenregistrierung, Sitzungen,
      Vertrauen, Zeugen, Compliance, Orchestrierung und Beobachtbarkeit
externalDocs:
  description: Transparenz-API nur lesend (separate Dienstspezifikation)
  url: >-
    https://github.com/truthlocks/truthlock/blob/main/docs/transparency/openapi.yaml
paths:
  /v1/audit/siem:
    post:
      tags:
        - Audit
      summary: SIEM-Ziel erstellen
      description: >-
        Verwalten Sie die gespeicherte SIEM-Zielkonfiguration in der
        authentifizierten Workspace-Umgebung. Neue Audit-Ereignisse mit
        verifizierter Umgebungszuordnung können zugestellt werden, wenn
        delivery_available true ist. Historische oder nicht zugeordnete
        Ereignisse werden nicht gestreamt; die Aktivierung ist kein Beweis für
        eine erfolgreiche Aufnahme. Anmeldeinformationen werden im Ruhezustand
        verschlüsselt und niemals zurückgegeben. API-Schlüssel erfordern
        audit:read zum Auflisten oder audit:write für Änderungen;
        Browsersitzungen erfordern Workspace-Administratorzugriff.
      operationId: createSiemDestination
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - provider
                - endpoint
              properties:
                provider:
                  type: string
                  description: SIEM-Anbietertyp.
                  enum:
                    - splunk
                    - datadog
                    - elastic
                    - webhook
                endpoint:
                  type: string
                  format: uri
                  description: >-
                    Öffentlicher HTTPS-Hostname auf Port 443, ohne
                    Benutzeranmeldeinformationen, Abfrageparameter oder
                    Fragment. Das Ändern des Endpunkts erfordert die erneute
                    Angabe der Anmeldeinformationen. Das Speichern validiert
                    weder den Besitz noch die Zustellung.
                  maxLength: 2048
                token:
                  type: string
                  description: >-
                    Token für Splunk-, Datadog- oder Elastic-Konfiguration. Bei
                    der Erstellung für diese Anbieter erforderlich. Geben Sie
                    kein Geheimnis an.
                  writeOnly: true
                  minLength: 16
                  maxLength: 8192
                secret:
                  type: string
                  description: >-
                    Gemeinsamer Schlüssel für die Webhook-Konfiguration. Bei der
                    Erstellung für Webhook erforderlich. Geben Sie kein Token
                    zusätzlich an.
                  writeOnly: true
                  minLength: 16
                  maxLength: 8192
                enabled:
                  type: boolean
                  default: false
                  description: >-
                    Ermöglicht die Zustellung neu aufgezeichneter
                    umweltbezogener Audit-Ereignisse. Erfordert
                    delivery_available=true; andernfalls gibt true 409 zurück.
                    Standardmäßig false beim Erstellen eines Ziels.
              additionalProperties: false
              example:
                provider: webhook
                endpoint: https://logs.example.com/ingest
                secret: replace-with-a-random-secret
                enabled: false
      responses:
        '201':
          description: SIEM-Ziel erstellt.
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    format: uuid
                  environment_id:
                    type: string
                    format: uuid
                  provider:
                    type: string
                    enum:
                      - splunk
                      - datadog
                      - elastic
                      - webhook
                  endpoint:
                    type: string
                    format: uri
                  enabled:
                    type: boolean
                  status:
                    type: string
                    enum:
                      - configured_delivery_unavailable
                      - disabled
                      - enabled
                  credential_configured:
                    type: boolean
                  created_at:
                    type: string
                    format: date-time
                  updated_at:
                    type: string
                    format: date-time
        '400':
          description: >-
            Ungültige Konfiguration, nicht unterstützte Felder,
            Anmeldeinformationstyp oder Bezeichner.
        '401':
          description: Nicht autorisiert
        '403':
          description: >-
            Anwendbarer Audit-Umfang oder Administratorzugriff auf den
            Arbeitsbereich erforderlich.
        '404':
          description: Ziel im authentifizierten Arbeitsbereich nicht gefunden.
        '409':
          description: >-
            Lieferung nicht verfügbar oder das Umgebungslimit von 20 Zielen
            erreicht.
        '500':
          description: >-
            Konfiguration konnte nicht gelesen oder gespeichert werden; kein
            Erfolg bestätigt.
      security:
        - APIKey: []
components:
  securitySchemes:
    APIKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: API-Schlüssel für die Maschine-zu-Maschine-Authentifizierung
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT für benutzerinitiierte Operationen

````

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