Definição
JSON Web Token: formato compacto para transportar declarações (claims) entre sistemas, assinado digitalmente e, opcionalmente, cifrado. Muito usado como token de acesso em APIs.
Como funciona
Um JWT assinado (RFC 7519) tem três partes em base64url separadas por pontos: o cabeçalho (algoritmo e tipo), o conteúdo (claims como sub, exp e iss) e a assinatura. A assinatura segue o JWS (RFC 7515), com HMAC ou chave pública (RSA, ECDSA).
Assinado não é cifrado: quem tem o token lê o conteúdo só decodificando o base64url. Não coloque senhas nem dados sensíveis num JWT comum.
Quem recebe o token deve verificar a assinatura com o algoritmo esperado, a validade (exp, nbf), o emissor (iss) e o público (aud). O RFC 8725 reúne as boas práticas, como nunca aceitar o algoritmo none.
Na prática
Cabeçalho e conteúdo decodificados de um JWT fictício:
cabeçalho: {"alg":"ES256","typ":"JWT"}
conteúdo: {"sub":"ramal-2001","iss":"https://auth.example.com","aud":"api-pbx","exp":1792500000}Erro comum
Emitir JWTs de longa duração sem forma de revogação. Um token assinado vale até o exp, mesmo que o usuário saia da empresa; use validade curta e tokens de renovação.
Termos relacionados
Referências
Padrões e documentação
- RFC 7519: JSON Web Token (JWT)
- RFC 7515: JSON Web Signature (JWS)
- RFC 8725: JSON Web Token Best Current Practices
Veja também o glossário completo, o blog e os cursos da EDCA.