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

# Crear destino SIEM

> Administrar destinos de entrega de auditoría protegidos y con ámbito de entorno.

> [!NOTE]
>
> Verifique `delivery_available` en la respuesta de la lista antes de habilitar un destino. La entrega cubre nuevos eventos de auditoría con atribución de entorno verificada. Los eventos históricos y no atribuidos no se transmiten. Un destino `enabled` no es evidencia de una ingesta exitosa; inspeccione `delivery_counts` y su receptor.

Utilice la clave de API para el entorno de sandbox o producción deseado. La lista requiere `audit:read`; los cambios requieren `audit:write`. Una sesión de navegador debe pertenecer a un administrador del espacio de trabajo. Un destino de otro inquilino o entorno no puede ser actualizado o eliminado.

Las credenciales se cifran en reposo y nunca aparecen en las respuestas. Para webhooks, proporcione `secret`; para Splunk, Datadog o Elastic, proporcione `token`. Cambiar un endpoint requiere proporcionar sus credenciales nuevamente. La configuración de CloudWatch no es compatible.

Un entorno puede contener hasta 20 destinos. La eliminación de un destino elimina su credencial guardada y los registros de entrega en cola. Deshabilitar o cambiar un destino cancela sus entregas pendientes; guarde cualquier evidencia de entrega que necesite primero.

Consulte la [guía de entrega de SIEM](https://docs.truthlocks.com/es/guides/siem-integration.md) para reintentos, configuraciones de proveedor y verificación de webhook. Para la ingesta de instantáneas, utilice [exportaciones de auditoría](https://docs.truthlocks.com/es/api-reference/audit/export.md) o [exportaciones de eventos de riesgo](https://docs.truthlocks.com/es/api-reference/risk/exports/create.md). Estas exportaciones no permiten la transmisión continua.


## OpenAPI

````yaml es/mint-openapi.yaml POST /v1/audit/siem
openapi: 3.0.3
info:
  title: Truthlocks API
  description: >
    Truthlocks es una infraestructura de verificación universal para documentos,
    credenciales y activos digitales.

    Esta especificación define la API canónica para interactuar con los
    servicios de Truthlocks.


    ## URLs Base

    - **Producción**: `https://api.truthlocks.com`

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


    ## Autenticación

    - **Claves API**: Use el encabezado `X-API-Key` para operaciones máquina a
    máquina

    - **Tokens Bearer**: Use `Authorization: Bearer <jwt>` para operaciones
    iniciadas por el usuario


    ## Identidad del Inquilino

    En producción, la identidad del inquilino se deriva del contexto autenticado
    (clave API o JWT).

    El encabezado `X-Tenant-ID` se ignora en producción para evitar la
    suplantación de identidad.
  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 producción
  - url: https://sandbox-api.truthlocks.com
    description: Entorno Sandbox
security:
  - APIKey: []
  - BearerAuth: []
tags:
  - name: Authentication
    description: Gestión de claves y tokens de API
  - name: Issuers
    description: Registro del emisor y gestión de la confianza
  - name: Keys
    description: Gestión de claves criptográficas para emisores
  - name: Attestations
    description: Ciclo de vida de la atestación (acuñar, revocar, reemplazar)
  - name: Verification
    description: Verificación de atestación y paquetes de prueba
  - name: Governance
    description: Flujos de trabajo de gobernanza del emisor (solo administrador)
  - name: Identity
    description: Gestión de organización, usuarios y roles
  - name: Audit
    description: Consultas de eventos de auditoría
  - name: Tenant Console
    description: Puntos finales de perfil y ciclo de vida del inquilino
  - name: Health
    description: Endpoints de estado y preparación del servicio
  - name: Risk
    description: Ingesta de señales de riesgo y detección de fraude
  - name: Risk Enforcement
    description: >-
      Acciones de aplicación de riesgos: bloqueo, desafío, cuarentena y
      configuración
  - name: Billing
    description: Gestión de facturación, suscripciones y complementos
  - name: Machine Identity
    description: >-
      Protocolo de Identidad de Agente de Máquina (MAIP) — registro de agentes,
      sesiones, confianza, testigo, cumplimiento, orquestación y observabilidad
externalDocs:
  description: API de transparencia de solo lectura (especificación de servicio separada)
  url: >-
    https://github.com/truthlocks/truthlock/blob/main/docs/transparency/openapi.yaml
paths:
  /v1/audit/siem:
    post:
      tags:
        - Audit
      summary: Crear destino SIEM
      description: >-
        Administre la configuración de destino SIEM guardada en el entorno de
        espacio de trabajo autenticado. Se pueden entregar nuevos eventos de
        auditoría con atribución de entorno verificada cuando delivery_available
        es verdadero. Los eventos históricos o no atribuidos no se transmiten;
        la habilitación no es prueba de una ingesta exitosa. Las credenciales se
        cifran en reposo y nunca se devuelven. Las claves de API requieren
        audit:read para listar o audit:write para cambios; las sesiones del
        navegador requieren acceso de administrador del espacio de trabajo.
      operationId: createSiemDestination
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - provider
                - endpoint
              properties:
                provider:
                  type: string
                  description: Tipo de proveedor SIEM.
                  enum:
                    - splunk
                    - datadog
                    - elastic
                    - webhook
                endpoint:
                  type: string
                  format: uri
                  description: >-
                    Nombre de host HTTPS público en el puerto 443, sin
                    credenciales de usuario, parámetros de consulta o fragmento.
                    Cambiar el endpoint requiere proporcionar la credencial
                    nuevamente. Guardar no valida la propiedad o la entrega.
                  maxLength: 2048
                token:
                  type: string
                  description: >-
                    Token para la configuración de Splunk, Datadog o Elastic.
                    Requerido en la creación para estos proveedores. No
                    proporcione también el secreto.
                  writeOnly: true
                  minLength: 16
                  maxLength: 8192
                secret:
                  type: string
                  description: >-
                    Secreto compartido para la configuración del webhook.
                    Requerido en la creación para el webhook. No proporcione
                    también el token.
                  writeOnly: true
                  minLength: 16
                  maxLength: 8192
                enabled:
                  type: boolean
                  default: false
                  description: >-
                    Habilita la entrega de eventos de auditoría recién
                    registrados atribuidos al entorno. Requiere
                    delivery_available=true; de lo contrario, true devuelve 409.
                    El valor predeterminado es false al crear un destino.
              additionalProperties: false
              example:
                provider: webhook
                endpoint: https://logs.example.com/ingest
                secret: replace-with-a-random-secret
                enabled: false
      responses:
        '201':
          description: Destino SIEM creado.
          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: >-
            Configuración no válida, campos no admitidos, tipo de credencial o
            identificador.
        '401':
          description: No autorizado
        '403':
          description: >-
            Se requiere un alcance de auditoría aplicable o acceso de
            administrador del espacio de trabajo.
        '404':
          description: >-
            Destino no encontrado en el entorno del espacio de trabajo
            autenticado.
        '409':
          description: >-
            Entrega no disponible o se alcanzó el límite de 20 destinos del
            entorno.
        '500':
          description: >-
            No se pudo leer o persistir la configuración; no se afirma ningún
            éxito.
      security:
        - APIKey: []
components:
  securitySchemes:
    APIKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: Clave API para autenticación máquina a máquina
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT para operaciones iniciadas por el usuario

````

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