Saltar para o conteúdo principal
POST
Registrar Chave
Cria uma chave gerenciada ou registra material de chave pública para o emissor identificado pelo parâmetro de caminho id.

Assinatura gerenciada

Use provider: "KMS" e o alg desejado. A geração gerenciada suporta Ed25519, ES256, ES384, RS256, RS512, PS256 e PS512. Consulte suporte a algoritmos e codificação. Use o kid gerado retornado na resposta; um ID de chave solicitado arbitrário não é retido neste modo.
A disponibilidade do algoritmo depende do provedor implantado. Um nome de algoritmo sozinho não estabelece conformidade com um padrão da indústria ou governamental.

Registro de chave pública

O modo de importação requer kid, alg e public_key_b64url. algorithm e public_key não são substitutos. Codifique os bytes da chave pública DER SubjectPublicKeyInfo como base64url sem preenchimento. O registo de uma chave pública não provisiona a sua chave privada, e é insuficiente por si só para a cunhagem do lado do servidor. Nunca envie material de chave privada nesta solicitação. A resposta inclui issuer_id, kid, alg, public_key_b64url, provider e created_at. Confirme a disponibilidade de assinatura antes de cunhar.

Autorizações

X-API-Key
string
header
obrigatório

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

Parâmetros de caminho

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

Deve corresponder à chave pública. A geração gerenciada suporta os sete algoritmos listados acima; o padrão é Ed25519.

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

Chave registrada

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>