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

# Lister la destination SIEM

> Gérer les destinations de livraison d'audit protégées et délimitées par l'environnement.

> [!NOTE]
>
> Vérifiez `delivery_available` dans la réponse de la liste avant d'activer une destination. La livraison couvre les nouveaux événements d'audit avec attribution d'environnement vérifiée. Les événements historiques et non attribués ne sont pas diffusés. Une destination `enabled` n'est pas une preuve d'ingestion réussie ; inspectez `delivery_counts` et votre récepteur.

Utilisez la clé API pour l'environnement sandbox ou de production prévu. La liste nécessite `audit:read` ; les modifications nécessitent `audit:write`. Une session de navigateur doit appartenir à un administrateur d'espace de travail. Une destination d'un autre locataire ou environnement ne peut pas être mise à jour ou supprimée.

Les identifiants sont chiffrés au repos et n'apparaissent jamais dans les réponses. Pour les webhooks, fournissez `secret` ; pour Splunk, Datadog ou Elastic, fournissez `token`. La modification d'un point de terminaison nécessite de fournir à nouveau ses identifiants. La configuration CloudWatch n'est pas prise en charge.

Un environnement peut contenir jusqu'à 20 destinations. La suppression d'une destination supprime ses identifiants enregistrés et ses enregistrements de livraison en file d'attente. La désactivation ou la modification d'une destination annule ses livraisons en attente ; enregistrez d'abord toutes les preuves de livraison dont vous avez besoin.

Consultez le [guide de livraison SIEM](https://docs.truthlocks.com/fr/guides/siem-integration.md) pour les tentatives, les paramètres du fournisseur et la vérification des webhooks. Pour l'ingestion d'instantanés, utilisez les [exportations d'audit](https://docs.truthlocks.com/fr/api-reference/audit/export.md) ou les [exportations d'événements à risque](https://docs.truthlocks.com/fr/api-reference/risk/exports/create.md). Ces exportations n'activent pas le streaming continu.


## OpenAPI

````yaml fr/mint-openapi.yaml GET /v1/audit/siem
openapi: 3.0.3
info:
  title: Truthlocks API
  description: >
    Truthlocks est une infrastructure de vérification universelle pour les
    documents, les identifiants et les actifs numériques.

    Cette spécification définit l'API canonique pour interagir avec les services
    Truthlocks.


    ## URL de base

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

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


    ## Authentification

    - **Clés API** : Utilisez l'en-tête `X-API-Key` pour les opérations de
    machine à machine

    - **Jetons Bearer** : Utilisez `Authorization: Bearer <jwt>` pour les
    opérations initiées par l'utilisateur


    ## Identité du locataire

    En production, l'identité du locataire est dérivée du contexte authentifié
    (clé API ou JWT).

    L'en-tête `X-Tenant-ID` est ignoré en production pour éviter l'usurpation
    d'identité.
  version: 1.0.0
  contact:
    name: Truthlocks Support
    url: https://truthlocks.com/support
    email: support@truthlocks.com
servers:
  - url: https://api.truthlocks.com
    description: API de production
  - url: https://sandbox-api.truthlocks.com
    description: Environnement de bac à sable
security:
  - APIKey: []
  - BearerAuth: []
tags:
  - name: Authentication
    description: Gestion des clés API et des jetons
  - name: Issuers
    description: Enregistrement de l'émetteur et gestion de la confiance
  - name: Keys
    description: Gestion des clés cryptographiques pour les émetteurs
  - name: Attestations
    description: Cycle de vie de l'attestation (créer, révoquer, remplacer)
  - name: Verification
    description: Vérification des attestations et lots de preuves
  - name: Governance
    description: Flux de travail de gouvernance de l'émetteur (administrateur uniquement)
  - name: Identity
    description: Gestion de l'organisation, des utilisateurs et des rôles
  - name: Audit
    description: Requêtes d'événements d'audit
  - name: Tenant Console
    description: Points de terminaison du profil et du cycle de vie du locataire
  - name: Health
    description: Points de terminaison de l'état et de la disponibilité du service
  - name: Risk
    description: Ingestion de signaux de risque et détection de fraude
  - name: Risk Enforcement
    description: >-
      Actions d'application des risques — blocage, défi, quarantaine et
      configuration
  - name: Billing
    description: Gestion de la facturation, des abonnements et des modules complémentaires
  - name: Machine Identity
    description: >-
      Protocole d'identité d'agent machine (MAIP) — enregistrement d'agent,
      sessions, confiance, témoin, conformité, orchestration et observabilité
externalDocs:
  description: API de transparence en lecture seule (spécification de service séparée)
  url: >-
    https://github.com/truthlocks/truthlock/blob/main/docs/transparency/openapi.yaml
paths:
  /v1/audit/siem:
    get:
      tags:
        - Audit
      summary: Lister les destinations SIEM
      description: >-
        Gérer la configuration de destination SIEM enregistrée dans
        l'environnement de l'espace de travail authentifié. De nouveaux
        événements d'audit avec une attribution d'environnement vérifiée peuvent
        être livrés lorsque delivery_available est vrai. Les événements
        historiques ou non attribués ne sont pas diffusés ; l'activation n'est
        pas une preuve d'ingestion réussie. Les informations d'identification
        sont chiffrées au repos et ne sont jamais renvoyées. Les clés API
        nécessitent audit:read pour la liste ou audit:write pour les
        modifications ; les sessions de navigateur nécessitent un accès
        administrateur de l'espace de travail.
      operationId: listSiemDestinations
      responses:
        '200':
          description: Tableau d'objets de destination SIEM.
          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: >-
                      Comptes de file d'attente pour cet environnement d'espace
                      de travail authentifié, à travers ses destinations.
                    additionalProperties:
                      type: integer
                      minimum: 0
                  coverage:
                    type: string
                    description: Explique la limite de couverture des événements.
                  delivery_available:
                    type: boolean
        '400':
          description: >-
            Configuration invalide, champs non pris en charge, type de
            credential ou identifiant.
        '401':
          description: Non autorisé
        '403':
          description: >-
            Accès requis à la portée d'audit applicable ou à l'administrateur de
            l'espace de travail.
        '404':
          description: >-
            Destination introuvable dans l'environnement de l'espace de travail
            authentifié.
        '409':
          description: >-
            Livraison indisponible ou la limite d'environnement de 20
            destinations atteinte.
        '500':
          description: >-
            La configuration n'a pas pu être lue ou persistée ; aucun succès
            n'est affirmé.
      security:
        - APIKey: []
components:
  securitySchemes:
    APIKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: Clé API pour l'authentification machine-à-machine
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT pour les opérations initiées par l'utilisateur

````

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