O conjunto usado na verificação de tokens
O JWKS (JSON Web Key Set) é um objeto JSON que reúne chaves criptográficas no campo keys. Cada chave é uma JWK (JSON Web Key), com parâmetros que descrevem seu tipo e seu material criptográfico. Na verificação de tokens assinados com chaves assimétricas, o emissor pode publicar as chaves públicas para que outras aplicações confiram as assinaturas.
Durante a troca de chaves do emissor, o parâmetro kid permite distinguir a chave usada na assinatura das outras disponíveis no conjunto. A procedência dessas chaves precisa estar associada ao emissor esperado. A aplicação também deve restringir os algoritmos que aceita, como orienta a RFC 8725.
Seleção pelo identificador da chave
Num exemplo didático, o cabeçalho de um token assinado contém "kid": "chave-2026-11". O verificador procura uma JWK com esse identificador no campo keys do conjunto confiável. Encontrá-la permite tentar a verificação com material compatível, mas a aceitação exige uma assinatura válida e as demais verificações do token.
Você deve conferir a configuração do emissor quando um token falhar após a troca de chaves. Aceitar qualquer conjunto indicado por uma entrada não confiável permitiria verificar uma assinatura com a chave de outro emissor. O formato também admite material privado ou simétrico, que precisa de proteção contra divulgação. O uso público do JWKS para assinaturas assimétricas expõe somente a parte pública das chaves.
Dúvidas frequentes
Perguntas frequentes sobre JWKS
- O kid comprova que a chave pertence ao emissor?
- O kid identifica uma chave no conjunto. A aplicação ainda precisa confirmar a associação das chaves ao emissor esperado e verificar a assinatura com um algoritmo permitido.
- Um JWKS contém somente chaves públicas?
- O formato também admite chaves privadas e simétricas. Um endereço público destinado à verificação de assinaturas deve expor apenas o material público necessário.
- A primeira chave da lista tem preferência?
- A ordem das chaves não indica preferência por padrão. A aplicação seleciona a chave compatível com o token e com as condições de verificação.
Para continuar
Recursos relacionados
Documentação
RFC 7517: chaves e conjuntos JSON Web Key
Define o campo keys, os parâmetros de uma JWK e os cuidados com chaves privadas ou simétricas.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Orientação técnica ao vivo para revisar a integração de autenticação e a configuração da verificação de tokens.
Abrir recursoAplicação na formação
Formação DevOps
A verificação de tokens exige configurar a origem das chaves e os algoritmos aceitos pela aplicação.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.