Como usar a ferramenta Decodificador de JWT
- Cole seu tokenCole um JWT na caixa. O prefixo “Bearer ” e as quebras de linha são removidos automaticamente.
- Leia o conteúdoO header e o payload são decodificados com cores, e cada claim é explicada em linguagem simples.
- Confira as datasExpiração (exp), emissão (iat) e “não antes de” (nbf) são convertidas em datas, com um selo claro de Expirado / Não expirado.
- Verifique a assinaturaEm tokens HS256, HS384 ou HS512, informe o segredo compartilhado para confirmar que o token é autêntico.
Recursos
- Decodificação instantâneaOs resultados aparecem assim que você cola. Sem botões, sem espera.
- Claims legíveisClaims padrão como iss, sub, aud e exp são rotuladas e explicadas.
- Status de expiraçãoVeja de relance se o token expirou ou ainda não é válido.
- Checagem de assinaturaVerifique tokens assinados com HMAC usando WebCrypto, no próprio navegador.
O que é um JWT?
Um JSON Web Token (JWT, pronunciado «jót») é um jeito compacto e seguro para URLs de transmitir afirmações (claims) entre duas partes. Ele é muito usado em sessões de login, autenticação de APIs e login único (OAuth 2.0 e OpenID Connect), inclusive no login do gov.br. Um JWT tem três partes separadas por pontos:
- Cabeçalho: o tipo de token e o algoritmo de assinatura, como HS256 ou RS256.
- Conteúdo (payload): os claims, por exemplo quem é o usuário e quando o token expira.
- Assinatura: prova que o token foi criado por alguém com a chave e que não foi alterado.
O cabeçalho e o conteúdo são só codificados em Base64URL, não criptografados. Qualquer pessoa com o token pode lê-los, que é exatamente o que esta ferramenta faz. Nunca coloque senhas ou outros segredos no conteúdo de um JWT. Os resultados se atualizam ao colar, sem botões nem espera.
Claims padrão
| Claim | Significado |
|---|---|
| iss | Emissor: quem criou o token |
| sub | Sujeito: normalmente o ID do usuário |
| aud | Audiência: para qual app ou API o token é |
| exp | Data de expiração, como timestamp Unix em segundos |
| nbf | Não antes de: o token não é válido antes desta data |
| iat | Emitido em: quando o token foi criado |
| jti | ID do JWT: identificador único para evitar reutilização |
As datas aparecem em formato legível, com uma etiqueta «Expirado» ou «Não expirado» de acordo com a hora atual do seu dispositivo. Para converter outro timestamp, use o Conversor de timestamp.
Decodificar não é verificar
Decodificar só mostra o que o token diz. Antes de confiar nele, um servidor precisa verificar a assinatura, conferir exp e nbf e confirmar o emissor e a audiência. Tokens com "alg": "none" não têm assinatura e devem sempre ser rejeitados.
- HS256, HS384, HS512 usam um segredo compartilhado para assinar e verificar. Digite o segredo acima para verificar; a checagem é feita com WebCrypto no seu navegador. Se o segredo estiver codificado, marque «O segredo está em Base64».
- RS256, ES256, PS256 e similares assinam com uma chave privada e são verificados com uma chave pública, que o emissor costuma publicar num endpoint JWKS. Verifique esses tokens no seu backend com uma biblioteca confiável.
Dicas de segurança
- Faça os tokens de acesso durarem pouco (minutos, não dias) e use refresh tokens para sessões longas.
- Use um segredo longo e aleatório com os algoritmos HMAC; um segredo curto ou fácil de adivinhar pode ser quebrado offline. Nosso Gerador de senhas pode criar um.
- Cole tokens de produção só em ferramentas que funcionam localmente, como esta.