Saltar para o conteúdo principal
POST
Rotacionar Chave do Emissor
Cria uma chave de substituição para uma chave ativa e expira atomicamente a chave antiga para novas emissões. A substituição permanece no mesmo emissor e ambiente. Use seu kid retornado explicitamente em solicitações de cunhagem subsequentes; os chamadores não são silenciosamente trocados para outra chave.

Gerar uma substituição

A geração gerenciada suporta Ed25519, ES256, ES384, RS256, RS512, PS256 e PS512. Para importação de chave pública, forneça kid, alg e public_key_b64url com SubjectPublicKeyInfo DER codificado como base64url sem preenchimento. O material público importado sozinho não pode cunhar novos registros. Consulte algoritmos de assinatura.

Registros existentes

A verificação usa o carimbo de data/hora de emissão registrado. Registros emitidos antes do corte da chave antiga ainda podem passar na verificação de assinatura com seu payload original. Uma chave comprometida ou revogada é rejeitada mesmo para registros mais antigos. Carimbos de data/hora confiáveis ausentes não podem ser substituídos por uma data fornecida pelo chamador. O sucesso retorna HTTP 201 com a chave de substituição e rotated_from. Uma chave aposentada não pode ser girada novamente. A expiração do registro, a revogação e as verificações de assinatura continuam a ser aplicadas independentemente.

Autorizações

X-API-Key
string
header
obrigatório

Chave de API para autenticação máquina a máquina

Parâmetros de caminho

kid
string
obrigatório

Corpo

application/json
provider
enum<string>
obrigatório

O KMS gera uma chave de assinatura dedicada. O DEV registra apenas material de verificação pública.

Opções disponíveis:
KMS
alg
enum<string>

Algoritmo de assinatura correspondente à chave.

Opções disponíveis:
Ed25519,
ES256,
ES384,
ES512,
RS256,
RS384,
RS512,
PS256,
PS384,
PS512
kid
string
public_key_b64url
string

SubjectPublicKeyInfo DER base64url sem preenchimento; necessário para importação, nunca envie material de chave privada.

Resposta

201 - application/json

Chave rotacionada

kid
string

Identificador da chave

issuer_id
string<uuid>
algorithm
enum<string>

Algoritmo de assinatura para geração de chave

Opções disponíveis:
Ed25519,
ES256,
ES384,
ES512,
RS256,
RS384,
RS512,
PS256,
PS384,
PS512
public_key
string

Chave pública codificada em Base64

status
enum<string>
Opções disponíveis:
ACTIVE,
DISABLED,
EXPIRED
not_before
string<date-time>
expires_at
string<date-time>