Saltar al contenido principal
POST
Rotar clave de emisor
Crea una clave de reemplazo para una clave activa y expira atómicamente la clave antigua para una nueva emisión. El reemplazo permanece en el mismo emisor y entorno. Utilice su kid devuelto explícitamente en las solicitudes de acuñación posteriores; los llamadores no se cambian silenciosamente a otra clave.

Generar un reemplazo

La generación gestionada admite Ed25519, ES256, ES384, RS256, RS512, PS256 y PS512. Para la importación de claves públicas, proporcione kid, alg y public_key_b64url con SubjectPublicKeyInfo DER codificado como base64url sin relleno. El material público importado por sí solo no puede acuñar nuevos registros. Consulte algoritmos de firma.

Registros existentes

La verificación utiliza la marca de tiempo de emisión registrada. Los registros emitidos antes del corte de la clave antigua aún pueden pasar la verificación de firma con su carga útil original. Una clave comprometida o revocada se rechaza incluso para registros más antiguos. Las marcas de tiempo confiables faltantes no pueden reemplazarse con una fecha proporcionada por el llamante. El éxito devuelve HTTP 201 con la clave de reemplazo y rotated_from. Una clave retirada no se puede rotar de nuevo. Las comprobaciones de caducidad, revocación y firma de registros continúan aplicándose de forma independiente.

Autorizaciones

X-API-Key
string
header
requerido

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

Parámetros de ruta

kid
string
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>

Algoritmo de firma que coincide con la clave.

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

201 - application/json

Clave rotada

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>