Passer au contenu principal
POST
Enregistrer la clé
Crée une clé gérée ou enregistre le matériel de clé publique pour l’émetteur identifié par le paramètre de chemin id.

Signature gérée

Utilisez provider: "KMS" et le alg souhaité. La génération gérée prend en charge Ed25519, ES256, ES384, RS256, RS512, PS256 et PS512. Voir prise en charge des algorithmes et encodage. Utilisez le kid généré renvoyé dans la réponse ; un ID de clé demandé arbitraire n’est pas conservé dans ce mode.
La disponibilité de l’algorithme dépend du fournisseur déployé. Un nom d’algorithme seul n’établit pas la conformité à une norme industrielle ou gouvernementale.

Enregistrement de clé publique

Le mode d’importation nécessite kid, alg et public_key_b64url. algorithm et public_key ne sont pas des substituts. Encodez les octets de la clé publique DER SubjectPublicKeyInfo en base64url non paddé. L’enregistrement d’une clé publique ne provisionne pas sa clé privée, et est insuffisant en soi pour la frappe côté serveur. N’envoyez jamais de matériel de clé privée dans cette requête. La réponse inclut issuer_id, kid, alg, public_key_b64url, provider et created_at. Confirmez la disponibilité de la signature avant de frapper.

Autorisations

X-API-Key
string
header
requis

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

Paramètres de chemin

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

Doit correspondre à la clé publique. La génération gérée prend en charge les sept algorithmes listés ci-dessus ; par défaut Ed25519.

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

Clé enregistré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>