Zum Hauptinhalt springen
POST
Schlüssel registrieren
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. Verwenden Sie die generierte kid, die in der Antwort zurückgegeben wird; eine beliebige angeforderte Schlüssel-ID wird in diesem Modus nicht beibehalten.
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.

Autorisierungen

X-API-Key
string
header
erforderlich

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

Pfadparameter

id
string<uuid>
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>

Muss dem öffentlichen Schlüssel entsprechen. Die verwaltete Generierung unterstützt die sieben oben aufgeführten Algorithmen; standardmäßig Ed25519.

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

Schlüssel registriert

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>