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

> 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 GET /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:
    get:
      tags:
        - Audit
      summary: SIEM-Ziele auflisten
      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: listSiemDestinations
      responses:
        '200':
          description: Array von SIEM-Zielobjekten.
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      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
                  delivery_counts:
                    type: object
                    description: >-
                      Warteschlangenanzahl für diese authentifizierte
                      Arbeitsbereichsumgebung über ihre Ziele hinweg.
                    additionalProperties:
                      type: integer
                      minimum: 0
                  coverage:
                    type: string
                    description: Erläutert die Grenze der Ereignisabdeckung.
                  delivery_available:
                    type: boolean
        '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.