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

# Créer une 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 POST /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:
    post:
      tags:
        - Audit
      summary: Créer une destination 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: createSiemDestination
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - provider
                - endpoint
              properties:
                provider:
                  type: string
                  description: Type de fournisseur SIEM.
                  enum:
                    - splunk
                    - datadog
                    - elastic
                    - webhook
                endpoint:
                  type: string
                  format: uri
                  description: >-
                    Nom d'hôte HTTPS public sur le port 443, sans identifiants
                    utilisateur, paramètres de requête ou fragment. La
                    modification du point de terminaison nécessite de fournir à
                    nouveau l'identifiant. La sauvegarde ne valide pas la
                    propriété ou la livraison.
                  maxLength: 2048
                token:
                  type: string
                  description: >-
                    Jeton pour la configuration Splunk, Datadog ou Elastic.
                    Requis à la création pour ces fournisseurs. Ne pas fournir
                    de secret également.
                  writeOnly: true
                  minLength: 16
                  maxLength: 8192
                secret:
                  type: string
                  description: >-
                    Secret partagé pour la configuration du webhook. Requis à la
                    création pour le webhook. Ne fournissez pas de jeton
                    également.
                  writeOnly: true
                  minLength: 16
                  maxLength: 8192
                enabled:
                  type: boolean
                  default: false
                  description: >-
                    Permet la livraison des événements d'audit nouvellement
                    enregistrés attribués à l'environnement. Nécessite
                    delivery_available=true ; sinon true renvoie 409. Par défaut
                    à false lors de la création d'une destination.
              additionalProperties: false
              example:
                provider: webhook
                endpoint: https://logs.example.com/ingest
                secret: replace-with-a-random-secret
                enabled: false
      responses:
        '201':
          description: Destination SIEM créée.
          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: >-
            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.