Como funciona
- Cole seu JWT.
- Leia o cabeçalho, os claims e o status de expiração.
- Se quiser, digite um segredo ou uma chave pública para verificar a assinatura.
Por que usar
- Datas legíveis para exp, iat e nbf.
- Verifica assinaturas HMAC, RSA e ECDSA.
- Mostra avisos sobre algoritmos como none.
- Seu token nunca sai da página.
Ler e verificar JSON Web Tokens
O que há dentro de um token
Um JSON Web Token são três pedaços de texto Base64 ligados por pontos: um cabeçalho, um payload e uma assinatura. O cabeçalho indica o algoritmo de assinatura; o payload contém os claims, como quem é o usuário e quando o token expira; a assinatura prova que quem criou o token conhecia a chave. Cole um token e os dois primeiros pedaços são decodificados e mostrados como JSON, com os claims padrão explicados em palavras simples:
| Claim | Significado |
|---|---|
iss | Emissor: o serviço que criou o token |
sub | Assunto: geralmente o ID do usuário |
aud | Público: o serviço a que o token se destina |
exp | Expira: depois deste momento o token deve ser recusado |
nbf | Não válido antes deste momento |
iat | Emitido em: quando o token foi criado |
Decodificar não é verificar
Qualquer pessoa decodifica um JWT; o payload não é criptografado, só codificado. Então nunca ponha segredos num token, e nunca confie nos claims de um token antes de a assinatura ser verificada. Para verificar um aqui, cole a chave:
- HS256, HS384, HS512 usam um único segredo compartilhado, o mesmo dos dois lados. Marque a opção Base64 se o segredo estiver guardado assim.
- Os algoritmos RS, PS e ES usam um par de chaves: o token é assinado com uma chave privada e verificado com a chave pública, que você pode colar como chave PEM, certificado ou JWK.
Um token assinado com alg: none não tem assinatura nenhuma, e o decodificador avisa: um servidor que o aceitasse confiaria em qualquer um que editasse o payload. As bibliotecas sempre devem ser informadas de quais algoritmos aceitar.
Mantenha tokens de produção privados
Um token válido é uma chave: quem o tem pode agir como aquele usuário até ele expirar. É por isso que este decodificador roda inteiro no seu navegador, e por isso convém ter cuidado com ferramentas online que mandam o token a um servidor. Prefira tokens de teste quando puder, e trate como vazado qualquer token real que você colou num lugar público.
Criar tokens de teste
A aba Codificar assina tokens com seu próprio cabeçalho, payload e chave, usando qualquer um dos doze algoritmos. Ela pode acrescentar o horário de emissão e uma expiração um número escolhido de minutos à frente. Útil para testar como uma API lida com tokens expirados, públicos errados ou claims faltando, sem mexer num login real.
Se algo der errado
- Diz que o token não é válido. Um JWT precisa ter exatamente dois pontos. Confira se nada foi cortado ao copiar; um
Bearerno início é removido para você. - A assinatura não é verificada. A chave está errada, o segredo deve ser lido como Base64, ou o token foi alterado depois de assinado.
- Diz que o token expirou, mas o servidor o aceita. O servidor pode permitir uma folga de relógio, ou nem conferir a expiração, o que vale corrigir.
Perguntas e respostas
É seguro colar um token real?
A decodificação é feita localmente e nada é enviado. Mesmo assim, trate tokens de produção como segredos e use tokens de teste quando puder.
Ele verifica uma assinatura?
Sim, com o segredo compartilhado para HS256 ou a chave pública para RS256 e ES256.
Por que meu token aparece como expirado?
O claim exp é um horário Unix. A ferramenta o compara com o relógio do seu dispositivo.