Passer au contenu principal
POST
Faire pivoter la clé de l'émetteur
Crée une clé de remplacement pour une clé active et expire atomiquement l’ancienne clé pour les nouvelles émissions. Le remplacement reste dans le même émetteur et environnement. Utilisez son kid renvoyé explicitement dans les demandes de frappe ultérieures ; les appelants ne sont pas silencieusement basculés vers une autre clé.

Générer un remplacement

La génération gérée prend en charge Ed25519, ES256, ES384, RS256, RS512, PS256 et PS512. Pour l’importation de clés publiques, fournissez kid, alg et public_key_b64url avec SubjectPublicKeyInfo DER encodé en base64url non rembourré. Le matériel public importé seul ne peut pas créer de nouveaux enregistrements. Voir algorithmes de signature.

Enregistrements existants

La vérification utilise l’horodatage d’émission enregistré. Les enregistrements émis avant la date limite de l’ancienne clé peuvent toujours passer la vérification de signature avec leur charge utile d’origine. Une clé compromise ou révoquée est rejetée même pour les enregistrements plus anciens. Les horodatages de confiance manquants ne peuvent pas être remplacés par une date fournie par l’appelant. Le succès renvoie HTTP 201 avec la clé de remplacement et rotated_from. Une clé retirée ne peut plus être renouvelée. Les vérifications d’expiration, de révocation et de signature des enregistrements continuent de s’appliquer indépendamment.

Autorisations

X-API-Key
string
header
requis

Clé API pour l'authentification machine-à-machine

Paramètres de chemin

kid
string
requis

Corps

application/json
provider
enum<string>
requis

KMS génère une clé de signature dédiée. DEV enregistre uniquement le matériel de vérification public.

Options disponibles:
KMS
alg
enum<string>

Algorithme de signature correspondant à la clé.

Options disponibles:
Ed25519,
ES256,
ES384,
ES512,
RS256,
RS384,
RS512,
PS256,
PS384,
PS512
kid
string
public_key_b64url
string

SubjectPublicKeyInfo DER base64url non rempli ; requis pour l'importation, n'envoyez jamais de matériel de clé privée.

Réponse

201 - application/json

Clé tournée

kid
string

Identifiant de clé

issuer_id
string<uuid>
algorithm
enum<string>

Algorithme de signature pour la génération de clés

Options disponibles:
Ed25519,
ES256,
ES384,
ES512,
RS256,
RS384,
RS512,
PS256,
PS384,
PS512
public_key
string

Clé publique encodée en Base64

status
enum<string>
Options disponibles:
ACTIVE,
DISABLED,
EXPIRED
not_before
string<date-time>
expires_at
string<date-time>