Pular para o conteúdo

Decodificador e depurador de JWT

  • Roda no seu dispositivo
  • Funciona offline depois de carregada

Cole um JSON Web Token para ler o cabeçalho e o payload, ver quando ele expira e conferir a assinatura com um segredo ou uma chave pública. Os claims de tempo aparecem como datas legíveis. Os tokens são decodificados no seu navegador e nunca são transmitidos.

Como funciona

  1. Cole seu JWT.
  2. Leia o cabeçalho, os claims e o status de expiração.
  3. 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:

ClaimSignificado
issEmissor: o serviço que criou o token
subAssunto: geralmente o ID do usuário
audPúblico: o serviço a que o token se destina
expExpira: depois deste momento o token deve ser recusado
nbfNão válido antes deste momento
iatEmitido em: quando o token foi criado
Os horários são timestamps Unix; o decodificador os mostra como datas e diz se o token expirou.

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 Bearer no 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.

Esc