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

# Schlüssel rotieren

> Erstellt einen Ersatzschlüssel im selben Aussteller und in derselben Umgebung und lässt den alten Schlüssel für neue Ausstellungen ablaufen. Vor dem Stichtag ausgestellte gespeicherte Aufzeichnungen behalten die Verifizierungsunterstützung, es sei denn, der Schlüssel ist kompromittiert oder widerrufen. Die verwaltete Generierung unterstützt Ed25519, ES256, ES384, RS256, RS512, PS256 und PS512.

Erstellt einen Ersatzschlüssel für einen aktiven Schlüssel und lässt den alten Schlüssel für neue Ausstellungen atomar ablaufen. Der Ersatz bleibt im selben Aussteller und in derselben Umgebung. Verwenden Sie seine zurückgegebene `kid` explizit in nachfolgenden Prägeanfragen; Aufrufer werden nicht stillschweigend auf einen anderen Schlüssel umgestellt.

## Einen Ersatz generieren

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

Die verwaltete Generierung unterstützt Ed25519, ES256, ES384, RS256, RS512, PS256 und PS512. Für den Import öffentlicher Schlüssel geben Sie `kid`, `alg` und `public_key_b64url` mit DER SubjectPublicKeyInfo an, die als unpadded base64url kodiert sind. Importiertes öffentliches Material allein kann keine neuen Datensätze prägen. Siehe [Signaturalgorithmen](https://docs.truthlocks.com/de/enterprise/signing-algorithms.md).

## Bestehende Aufzeichnungen

Die Verifizierung verwendet den registrierten Ausstellungszeitstempel. Datensätze, die vor dem Stichtag des alten Schlüssels ausgestellt wurden, können die Signaturverifizierung weiterhin mit ihrer ursprünglichen Nutzlast bestehen. Ein kompromittierter oder widerrufener Schlüssel wird auch für ältere Datensätze abgelehnt. Fehlende vertrauenswürdige Zeitstempel können nicht durch ein vom Aufrufer bereitgestelltes Datum ersetzt werden.

Bei Erfolg wird HTTP **201** mit dem Ersatzschlüssel und `rotated_from` zurückgegeben. Ein ausgemusterter Schlüssel kann nicht erneut rotiert werden. Ablauf-, Widerrufs- und Signaturprüfungen gelten weiterhin unabhängig voneinander.


## OpenAPI

````yaml de/mint-openapi.yaml POST /v1/issuers/keys/{kid}/rotate
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/keys/{kid}/rotate:
    post:
      tags:
        - Keys
      summary: Ausstellerschlüssel rotieren
      description: >-
        Erstellt einen Ersatzschlüssel im selben Aussteller und in derselben
        Umgebung und lässt den alten Schlüssel für neue Ausstellungen ablaufen.
        Vor dem Stichtag ausgestellte gespeicherte Aufzeichnungen behalten die
        Verifizierungsunterstützung, es sei denn, der Schlüssel ist
        kompromittiert oder widerrufen. Die verwaltete Generierung unterstützt
        Ed25519, ES256, ES384, RS256, RS512, PS256 und PS512.
      parameters:
        - name: kid
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                alg:
                  $ref: '#/components/schemas/SigningAlgorithm'
                  description: Signaturalgorithmus, der dem Schlüssel entspricht.
                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 rotiert
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Key'
      security:
        - APIKey: []
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
  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.