Saltar al contenido principal
POST
Registrar clave
Crea una clave gestionada o registra material de clave pública para el emisor identificado por el parámetro de ruta id.

Firma gestionada

Use provider: "KMS" y el alg deseado. La generación administrada admite Ed25519, ES256, ES384, RS256, RS512, PS256 y PS512. Consulte compatibilidad de algoritmos y codificación. Use el kid generado devuelto en la respuesta; un ID de clave solicitado arbitrario no se retiene en este modo.
La disponibilidad del algoritmo depende del proveedor implementado. Un nombre de algoritmo por sí solo no establece el cumplimiento de un estándar industrial o gubernamental.

Registro de clave pública

El modo de importación requiere kid, alg y public_key_b64url. algorithm y public_key no son sustitutos. Codifique los bytes de la clave pública DER SubjectPublicKeyInfo como base64url sin relleno. Registrar una clave pública no aprovisiona su clave privada, y es insuficiente por sí mismo para la acuñación del lado del servidor. Nunca envíe material de clave privada en esta solicitud. La respuesta incluye issuer_id, kid, alg, public_key_b64url, provider y created_at. Confirme la disponibilidad de la firma antes de la acuñación.

Autorizaciones

X-API-Key
string
header
requerido

Clave API para autenticación máquina a máquina

Parámetros de ruta

id
string<uuid>
requerido

Cuerpo

application/json
provider
enum<string>
requerido

KMS genera una clave de firma dedicada. DEV registra solo material de verificación pública.

Opciones disponibles:
KMS
alg
enum<string>

Debe coincidir con la clave pública. La generación gestionada admite los siete algoritmos enumerados anteriormente; el valor predeterminado es Ed25519.

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

SubjectPublicKeyInfo DER base64url sin relleno; requerido para la importación, nunca envíe material de clave privada.

Respuesta

Clave registrada

kid
string

Identificador de clave

issuer_id
string<uuid>
algorithm
enum<string>

Algoritmo de firma para la generación de claves

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

Clave pública codificada en Base64

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