> ## 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 ou enregistrer une clé d'émetteur

> Crée une clé gérée dédiée ou enregistre une clé de vérification publique externe. La génération gérée prend en charge Ed25519, ES256, ES384, RS256, RS512, PS256 et PS512. L'importation prend également en charge ES512, RS384 et PS384 ; l'importation d'une clé publique n'active pas la frappe côté serveur.

Crée une clé gérée ou enregistre le matériel de clé publique pour l'émetteur identifié par le paramètre de chemin `id`.

## Signature gérée

Utilisez `provider: "KMS"` et le `alg` souhaité. La génération gérée prend en charge **Ed25519, ES256, ES384, RS256, RS512, PS256 et PS512**. Voir [prise en charge des algorithmes et encodage](https://docs.truthlocks.com/fr/enterprise/signing-algorithms.md). Utilisez le `kid` généré renvoyé dans la réponse ; un ID de clé demandé arbitraire n'est pas conservé dans ce mode.

```json theme={null}
{"provider": "KMS", "alg": "Ed25519"}
```

La disponibilité de l'algorithme dépend du fournisseur déployé. Un nom d'algorithme seul n'établit pas la conformité à une norme industrielle ou gouvernementale.

## Enregistrement de clé publique

Le mode d'importation nécessite `kid`, `alg` et `public_key_b64url`. `algorithm` et `public_key` ne sont pas des substituts. Encodez les octets de la clé publique DER SubjectPublicKeyInfo en base64url non paddé.

L'enregistrement d'une clé publique ne provisionne **pas** sa clé privée, et est insuffisant en soi pour la frappe côté serveur. N'envoyez jamais de matériel de clé privée dans cette requête.

La réponse inclut `issuer_id`, `kid`, `alg`, `public_key_b64url`, `provider` et `created_at`. Confirmez la disponibilité de la signature avant de frapper.


## OpenAPI

````yaml fr/mint-openapi.yaml POST /v1/issuers/{id}/keys
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/issuers/{id}/keys:
    post:
      tags:
        - Keys
      summary: Enregistrer la clé
      description: >-
        Crée une clé gérée dédiée ou enregistre une clé de vérification publique
        externe. La génération gérée prend en charge Ed25519, ES256, ES384,
        RS256, RS512, PS256 et PS512. L'importation prend également en charge
        ES512, RS384 et PS384 ; l'importation d'une clé publique n'active pas la
        frappe côté serveur.
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                alg:
                  $ref: '#/components/schemas/SigningAlgorithm'
                  description: >-
                    Doit correspondre à la clé publique. La génération gérée
                    prend en charge les sept algorithmes listés ci-dessus ; par
                    défaut Ed25519.
                kid:
                  type: string
                provider:
                  type: string
                  enum:
                    - KMS
                    - DEV
                  description: >-
                    KMS génère une clé de signature dédiée. DEV enregistre
                    uniquement le matériel de vérification public.
                public_key_b64url:
                  type: string
                  description: >-
                    SubjectPublicKeyInfo DER base64url non rempli ; requis pour
                    l'importation, n'envoyez jamais de matériel de clé privée.
              type: object
              oneOf:
                - title: Managed signing key
                  required:
                    - provider
                  properties:
                    provider:
                      enum:
                        - KMS
                - title: Imported public verification key
                  required:
                    - kid
                    - alg
                    - public_key_b64url
                  properties:
                    provider:
                      enum:
                        - DEV
      responses:
        '201':
          description: Clé enregistrée
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Key'
        '400':
          description: Algorithme ou format de clé invalide
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
              example:
                code: VALIDATION_ERROR
                message: >-
                  Unsupported algorithm. Must be one of: ES256, ES384, ES512,
                  RS256, RS384, RS512, PS256, PS384, PS512, Ed25519
                http_status: 400
      security:
        - APIKey: []
        - BearerAuth: []
components:
  schemas:
    SigningAlgorithm:
      type: string
      enum:
        - Ed25519
        - ES256
        - ES384
        - ES512
        - RS256
        - RS384
        - RS512
        - PS256
        - PS384
        - PS512
      description: Algorithme de signature pour la génération de clés
    Key:
      type: object
      properties:
        kid:
          type: string
          description: Identifiant de clé
        issuer_id:
          type: string
          format: uuid
        algorithm:
          $ref: '#/components/schemas/SigningAlgorithm'
        public_key:
          type: string
          description: Clé publique encodée en Base64
        status:
          type: string
          enum:
            - ACTIVE
            - DISABLED
            - EXPIRED
        not_before:
          type: string
          format: date-time
        expires_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.