> ## 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 vérification de conformité

> Exécuter une vérification de conformité automatisée par rapport à une réglementation pour une entité

Exécute une évaluation de conformité automatisée pour une entité spécifique (agent, modèle, ensemble de données ou flux de travail) par rapport à une réglementation prise en charge. La vérification évalue la configuration de l'entité, les modèles d'accès, la gestion des données et la piste d'audit par rapport aux exigences de la réglementation et produit une détermination de conformité avec des constatations détaillées.

Les vérifications de conformité sont idempotentes pour la même paire entité-réglementation dans une fenêtre de 24 heures. Les appels répétés dans cette fenêtre renvoient le résultat mis en cache.

### Authentification

Nécessite l'en-tête `X-API-Key` ou un jeton JWT Bearer. L'espace de travail est dérivé de l'identifiant authentifié ; n'envoyez pas `X-Tenant-ID`.

### Réponse

**id** `string`

Identifiant unique de l'enregistrement de vérification de conformité. Format : `maip-cc:ULID`.

**entity\_type** `string`

Le type d'entité qui a été évalué.

**entity\_id** `string`

L'identifiant de l'entité évaluée.

**regulation** `string`

La réglementation qui a été évaluée.

**scope** `string`

La portée de l'évaluation. `full` si aucune portée n'a été spécifiée.

**status** `string`

La détermination de la conformité. L'un des éléments suivants : - `compliant` -- l'entité répond à toutes les exigences
exigences évaluées - `non_compliant` -- l'entité échoue à une ou plusieurs exigences critiques
exigences - `partial` -- l'entité satisfait à certaines mais pas à toutes les exigences

**findings** `object[]`

Liste détaillée des constatations individuelles de l'évaluation.

**Finding fields**

**findings\[].control\_id** `string`

L'identifiant de contrôle au sein de la réglementation (par exemple, `CC6.1` pour SOC2, `A.9.1.1` pour ISO27001).

**findings\[].control\_name** `string`

Nom lisible par l'homme du contrôle.

**findings\[].status** `string`

Statut de ce contrôle spécifique : `pass`, `fail`, `partial`, `not_applicable`.

**findings\[].severity** `string`

Gravité de la constatation si elle n'est pas satisfaisante : `critical`, `high`, `medium`, `low`.

**findings\[].description** `string`

Description détaillée de la constatation et conseils de remédiation.

**receipt\_id** `string`

Le reçu MAIP émis pour cette vérification de conformité, fournissant un
enregistrement d'audit.

**checked\_at** `string`

Horodatage ISO 8601 du moment où l'évaluation a été effectuée.

### Réglementations prises en charge

| Réglementation | Contrôles évalués | Durée typique |
| :- | :- | :- |
| `SOC2` | Critères de service de confiance (CC1-CC9) | 2-5 secondes |
| `ISO27001` | Contrôles de l'annexe A (A.5-A.18) | 2-5 secondes |
| `GDPR` | Articles 5, 6, 12-22, 25, 32-34 | 3-8 secondes |
| `HIPAA` | Mesures de protection administratives, physiques, techniques | 3-8 secondes |
| `EU_AI_ACT` | Classification des risques, transparence, supervision humaine | 5-10 secondes |


## OpenAPI

````yaml fr/mint-openapi.yaml POST /v1/compliance/check
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/compliance/check:
    post:
      tags:
        - Machine Identity
      summary: Créer une vérification de conformité
      description: >-
        Lance une vérification de conformité pour un agent par rapport à un
        cadre réglementaire spécifié. Renvoie les résultats avec des
        classifications de gravité.
      operationId: maip.compliance.check
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                auditor_id:
                  type: string
                check_type:
                  type: string
                entity_id:
                  type: string
                entity_type:
                  type: string
                evidence_hash:
                  nullable: true
                  type: string
                metadata: {}
                notes:
                  type: string
                regulation:
                  type: string
                requirement_id:
                  type: string
                result:
                  type: string
                ttl_days:
                  type: integer
              type: object
              required:
                - entity_id
                - regulation
                - requirement_id
                - result
                - auditor_id
      responses:
        '201':
          description: Vérification de conformité créée
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MaipComplianceCheck'
        '400':
          description: Erreur de validation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '401':
          description: Authentification requise
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '429':
          description: Limite de débit dépassée
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
      security:
        - APIKey: []
components:
  schemas:
    MaipComplianceCheck:
      type: object
      properties:
        check_id:
          type: string
          format: uuid
        agent_id:
          type: string
          format: uuid
        framework:
          type: string
          enum:
            - soc2
            - iso27001
            - hipaa
            - gdpr
        scope:
          type: object
          additionalProperties: true
        status:
          type: string
          enum:
            - pending
            - passed
            - failed
            - partial
        findings:
          type: array
          items:
            type: object
            properties:
              finding_id:
                type: string
              severity:
                type: string
                enum:
                  - low
                  - medium
                  - high
                  - critical
              title:
                type: string
              description:
                type: string
        created_at:
          type: string
          format: date-time
    ErrorEnvelope:
      type: object
      required:
        - code
        - message
        - http_status
      properties:
        code:
          type: string
          description: Code d'erreur lisible par machine
          enum:
            - AUTH_REQUIRED
            - AUTH_INVALID
            - PERMISSION_DENIED
            - TENANT_IDENTITY_UNVERIFIED
            - NOT_FOUND
            - VALIDATION_ERROR
            - CONFLICT
            - PAYLOAD_TOO_LARGE
            - RATE_LIMIT_EXCEEDED
            - QUOTA_EXCEEDED
            - SERVICE_UNAVAILABLE
            - INTERNAL_ERROR
        message:
          type: string
          description: Message d'erreur lisible par l'homme
        http_status:
          type: integer
          description: Code de statut HTTP
        retry_after_ms:
          type: integer
          description: >-
            Millisecondes à attendre avant de réessayer (pour les limites de
            débit)
        details:
          type: object
          description: Contexte d'erreur supplémentaire
      example:
        code: AUTH_REQUIRED
        message: Authentication required
        http_status: 401
  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.