Declarações transportadas entre sistemas
O JWT (JSON Web Token) é um formato compacto para transportar declarações entre sistemas. Cada declaração, chamada claim, associa um nome a um valor em um objeto JSON. O campo iss identifica o emissor e o campo aud indica o destinatário. A aplicação define quais declarações exige para aceitar o token.
A RFC 7519 prevê declarações assinadas ou cifradas. Na representação compacta de um JWT assinado, três partes separadas por pontos carregam o cabeçalho, as declarações e a assinatura. As duas primeiras usam a codificação base64url, que permite recuperar o conteúdo sem conhecer a chave. Para manter essas declarações em sigilo, é necessário cifrar o conteúdo.
Por que o destinatário precisa ser conferido
Neste exemplo didático, o conteúdo decodificado de um token inclui "iss": "login.exemplo" e "aud": "relatorios". O serviço de relatórios reconhece esse emissor e espera esse destinatário. Ao receber o mesmo token, o serviço de cobrança deve recusá-lo porque o destinatário informado não corresponde ao serviço de cobrança, mesmo que a assinatura seja válida.
Você consegue inspecionar esses campos com um decodificador, mas essa leitura ainda não confirma a autenticidade do token. O serviço precisa verificar a assinatura com uma chave confiável e aplicar as condições de aceitação. A RFC 8725 exige conferir o destinatário quando o emissor produz tokens para mais de uma aplicação.
Algoritmo e prazo de validade
O campo alg do cabeçalho informa um algoritmo, mas a aplicação deve aceitar somente os algoritmos permitidos por sua própria configuração. Confiar livremente no valor recebido permitiria ao remetente escolher como o serviço verifica o token.
Quando presente, o campo exp estabelece um instante de expiração. O serviço deve recusar o token a partir desse instante, admitida uma pequena tolerância configurada para diferenças entre relógios. A verificação da assinatura e a conferência do prazo têm funções distintas: um token pode manter a assinatura correta depois de expirar.
Dúvidas frequentes
Perguntas frequentes sobre JWT
- O conteúdo de um JWT fica secreto?
- Um JWT apenas assinado mantém o conteúdo legível por qualquer aplicativo que receba o token. Para manter as declarações em sigilo, é necessário usar criptografia adequada, como a estrutura JWE (JSON Web Encryption) prevista pelo padrão.
- Uma assinatura válida autoriza qualquer ação?
- A assinatura confirma a integridade com a chave usada na verificação. O serviço também confere o emissor, o destinatário e os prazos exigidos pela aplicação. A permissão para executar uma ação depende do sistema de autorização.
- Como encerrar o acesso com um token ainda válido?
- O formato JWT não define um procedimento geral de revogação. A aplicação precisa estabelecer como recusar tokens anteriormente emitidos, por exemplo consultando uma lista de tokens revogados até o vencimento. Apagar o token no navegador não invalida outras cópias.
Para continuar
Recursos relacionados
Site de referência
Desenvolvimento Colaborativo da Dev Side Studio
Orientação técnica ao vivo para revisar a validação de JWTs na aplicação e testar a recusa de tokens destinados a outro serviço.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
O JWT exige validação do emissor e da finalidade quando a aplicação o utiliza em autenticação ou autorização.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.