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

# Ausstellerschlüssel erstellen oder registrieren

> Erstellt einen dedizierten verwalteten Schlüssel oder registriert einen externen öffentlichen Verifizierungsschlüssel. Die verwaltete Generierung unterstützt Ed25519, ES256, ES384, RS256, RS512, PS256 und PS512. Der Import unterstützt zusätzlich ES512, RS384 und PS384; der Import eines öffentlichen Schlüssels ermöglicht kein serverseitiges Prägen.

Erstellt einen verwalteten Schlüssel oder registriert Public-Key-Material für den durch den Pfadparameter `id` identifizierten Aussteller.

## Verwaltete Signierung

Verwenden Sie `provider: "KMS"` und den gewünschten `alg`. Die verwaltete Generierung unterstützt **Ed25519, ES256, ES384, RS256, RS512, PS256 und PS512**. Siehe [Algorithmusunterstützung und Kodierung](https://docs.truthlocks.com/de/enterprise/signing-algorithms.md). Verwenden Sie die generierte `kid`, die in der Antwort zurückgegeben wird; eine beliebige angeforderte Schlüssel-ID wird in diesem Modus nicht beibehalten.

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

Die Verfügbarkeit des Algorithmus hängt vom bereitgestellten Anbieter ab. Ein Algorithmusname allein begründet keine Konformität mit einem Industrie- oder Regierungsstandard.

## Registrierung öffentlicher Schlüssel

Der Importmodus erfordert `kid`, `alg` und `public_key_b64url`. `algorithm` und `public_key` sind keine Ersatzstoffe. Kodieren Sie die DER SubjectPublicKeyInfo Public-Key-Bytes als ungepolstertes base64url.

Das Registrieren eines öffentlichen Schlüssels stellt **nicht** seinen privaten Schlüssel bereit und ist allein für das serverseitige Minting nicht ausreichend. Senden Sie niemals privates Schlüsselmaterial in dieser Anfrage.

Die Antwort enthält `issuer_id`, `kid`, `alg`, `public_key_b64url`, `provider` und `created_at`. Bestätigen Sie die Verfügbarkeit der Signatur vor dem Prägen.


## OpenAPI

````yaml de/mint-openapi.yaml POST /v1/issuers/{id}/keys
openapi: 3.0.3
info:
  title: Truthlocks API
  description: >
    Truthlocks ist eine universelle Verifizierungsinfrastruktur für Dokumente,
    Anmeldeinformationen und digitale Assets.

    Diese Spezifikation definiert die kanonische API für die Interaktion mit
    Truthlocks-Diensten.


    ## Basis-URLs

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

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


    ## Authentifizierung

    - **API-Schlüssel**: Verwenden Sie den Header `X-API-Key` für
    Machine-to-Machine-Operationen

    - **Bearer Tokens**: Verwenden Sie `Authorization: Bearer <jwt>` für
    benutzerinitiierte Operationen


    ## Mandantenidentität

    In der Produktion wird die Mandantenidentität aus dem authentifizierten
    Kontext (API-Schlüssel oder JWT) abgeleitet.

    Der Header `X-Tenant-ID` wird in der Produktion ignoriert, um Spoofing zu
    verhindern.
  version: 1.0.0
  contact:
    name: Truthlocks Support
    url: https://truthlocks.com/support
    email: support@truthlocks.com
servers:
  - url: https://api.truthlocks.com
    description: Produktions-API
  - url: https://sandbox-api.truthlocks.com
    description: Sandbox-Umgebung
security:
  - APIKey: []
  - BearerAuth: []
tags:
  - name: Authentication
    description: API-Schlüssel- und Token-Verwaltung
  - name: Issuers
    description: Ausstellerregistrierung und Vertrauensmanagement
  - name: Keys
    description: Kryptographische Schlüsselverwaltung für Aussteller
  - name: Attestations
    description: Bestätigungslebenszyklus (prägen, widerrufen, ersetzen)
  - name: Verification
    description: Bestätigungsverifizierung und Proof-Bundles
  - name: Governance
    description: Aussteller-Governance-Workflows (nur Admin)
  - name: Identity
    description: Organisations-, Benutzer- und Rollenverwaltung
  - name: Audit
    description: Audit-Ereignisabfragen
  - name: Tenant Console
    description: Mandantenprofil- und Lebenszyklus-Endpunkte
  - name: Health
    description: Endpunkte für Dienststatus und Bereitschaft
  - name: Risk
    description: Erfassung von Risikosignalen und Betrugserkennung
  - name: Risk Enforcement
    description: >-
      Risikodurchsetzungsmaßnahmen – Blockieren, Herausfordern, Quarantäne und
      Konfiguration
  - name: Billing
    description: Verwaltung von Abrechnung, Abonnements und Add-ons
  - name: Machine Identity
    description: >-
      Machine Agent Identity Protocol (MAIP) – Agentenregistrierung, Sitzungen,
      Vertrauen, Zeugen, Compliance, Orchestrierung und Beobachtbarkeit
externalDocs:
  description: Transparenz-API nur lesend (separate Dienstspezifikation)
  url: >-
    https://github.com/truthlocks/truthlock/blob/main/docs/transparency/openapi.yaml
paths:
  /v1/issuers/{id}/keys:
    post:
      tags:
        - Keys
      summary: Schlüssel registrieren
      description: >-
        Erstellt einen dedizierten verwalteten Schlüssel oder registriert einen
        externen öffentlichen Verifizierungsschlüssel. Die verwaltete
        Generierung unterstützt Ed25519, ES256, ES384, RS256, RS512, PS256 und
        PS512. Der Import unterstützt zusätzlich ES512, RS384 und PS384; der
        Import eines öffentlichen Schlüssels ermöglicht kein serverseitiges
        Prägen.
      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: >-
                    Muss dem öffentlichen Schlüssel entsprechen. Die verwaltete
                    Generierung unterstützt die sieben oben aufgeführten
                    Algorithmen; standardmäßig Ed25519.
                kid:
                  type: string
                provider:
                  type: string
                  enum:
                    - KMS
                    - DEV
                  description: >-
                    KMS generiert einen dedizierten Signierschlüssel. DEV
                    registriert nur öffentliches Verifizierungsmaterial.
                public_key_b64url:
                  type: string
                  description: >-
                    Ungepolsterte base64url DER SubjectPublicKeyInfo; für den
                    Import erforderlich, niemals privates Schlüsselmaterial
                    senden.
              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: Schlüssel registriert
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Key'
        '400':
          description: Ungültiger Algorithmus oder Schlüsselformat
          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: Signaturalgorithmus für die Schlüsselgenerierung
    Key:
      type: object
      properties:
        kid:
          type: string
          description: Schlüsselbezeichner
        issuer_id:
          type: string
          format: uuid
        algorithm:
          $ref: '#/components/schemas/SigningAlgorithm'
        public_key:
          type: string
          description: Base64-kodierter öffentlicher Schlüssel
        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: Maschinenlesbarer Fehlercode
          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: Menschenlesbare Fehlermeldung
        http_status:
          type: integer
          description: HTTP-Statuscode
        retry_after_ms:
          type: integer
          description: >-
            Millisekunden, die vor einem erneuten Versuch gewartet werden sollen
            (für Ratenbegrenzungen)
        details:
          type: object
          description: Zusätzlicher Fehlerkontext
      example:
        code: AUTH_REQUIRED
        message: Authentication required
        http_status: 401
  securitySchemes:
    APIKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: API-Schlüssel für die Maschine-zu-Maschine-Authentifizierung
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT für benutzerinitiierte Operationen

````

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