Zum Hauptinhalt springen
POST
Ausstellerschlüssel rotieren
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

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.

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.

Autorisierungen

X-API-Key
string
header
erforderlich

API-Schlüssel für die Maschine-zu-Maschine-Authentifizierung

Pfadparameter

kid
string
erforderlich

Body

application/json
provider
enum<string>
erforderlich

KMS generiert einen dedizierten Signierschlüssel. DEV registriert nur öffentliches Verifizierungsmaterial.

Verfügbare Optionen:
KMS
alg
enum<string>

Signaturalgorithmus, der dem Schlüssel entspricht.

Verfügbare Optionen:
Ed25519,
ES256,
ES384,
ES512,
RS256,
RS384,
RS512,
PS256,
PS384,
PS512
kid
string
public_key_b64url
string

Ungepolsterte base64url DER SubjectPublicKeyInfo; für den Import erforderlich, niemals privates Schlüsselmaterial senden.

Antwort

201 - application/json

Schlüssel rotiert

kid
string

Schlüsselbezeichner

issuer_id
string<uuid>
algorithm
enum<string>

Signaturalgorithmus für die Schlüsselgenerierung

Verfügbare Optionen:
Ed25519,
ES256,
ES384,
ES512,
RS256,
RS384,
RS512,
PS256,
PS384,
PS512
public_key
string

Base64-kodierter öffentlicher Schlüssel

status
enum<string>
Verfügbare Optionen:
ACTIVE,
DISABLED,
EXPIRED
not_before
string<date-time>
expires_at
string<date-time>