Descodificador de JWT

Como descodificar um JWT

1. Cola o token em JSON Web Token. Também podes colar um valor Authorization: Bearer … completo: o prefixo Bearer e as quebras de linha são removidos.
2. O token é descodificado à medida que escreves (ou quando clicas em Descodificar). O Cabeçalho e o Payload aparecem como JSON formatado, cada um com o seu botão Copiar.
3. Consulta a tabela Claims de tempo: exp, nbf e iat são mostrados com o valor bruto, a data no teu fuso horário, um tempo relativo («daqui a 3 horas», «há 2 dias») e um estado como Expirado ou Ainda não válido.
4. Lê os avisos acima dos resultados, por exemplo quando alg é none ou quando uma data parece estar em milissegundos.
5. Para verificar a assinatura, preenche a chave em Verificar a assinatura e clica em Verificar assinatura.

Descodificar não é verificar

Um JWT são três partes em Base64url separadas por pontos: header.payload.signature. O cabeçalho e o payload estão apenas codificados, não encriptados: qualquer pessoa que tenha o token consegue lê-los, e esta ferramenta descodifica qualquer token sem precisar de chave. Isso também significa que um payload descodificado não prova nada, porque alguém pode tê-lo alterado. Só uma assinatura válida mostra que o token foi emitido por quem tem a chave e que não foi modificado desde então. Por isso, a linha de estado diz «Descodificado (assinatura não verificada).» enquanto não fizeres a verificação.

Um token com cinco partes é um JWE (JWT encriptado). O conteúdo não pode ser lido sem a chave de desencriptação, e a ferramenta avisa-te disso.

Verificar a assinatura

• HS256, HS384, HS512 (HMAC): introduz o Segredo partilhado. Em Formato do segredo, indica se é texto simples (UTF-8) ou Base64/Base64url, porque alguns fornecedores guardam os segredos em Base64. Também podes colar um JWK do tipo oct. Se o segredo for mais curto do que o resultado do hash (32 bytes para HS256), a ferramenta avisa que está abaixo do mínimo do RFC 7518.
• RS256/384/512, PS256/384/512, ES256/384/512 e EdDSA: cola a Chave pública (PEM ou JWK). São aceites os blocos PEM PUBLIC KEY, RSA PUBLIC KEY e CERTIFICATE (a chave é lida do certificado X.509). Um JWK ou um JWK Set inteiro também funciona: é usada a chave cujo kid coincide com o do cabeçalho. As chaves privadas são recusadas, porque um verificador nunca precisa delas. O EdDSA suporta Ed25519 nos navegadores cuja Web Crypto o implementa.

A verificação usa a API Web Crypto do navegador. «Assinatura inválida» significa que a chave está errada ou que o token foi alterado. Repara que o algoritmo é lido do cabeçalho do token: um servidor real deve fixar o algoritmo esperado na configuração, caso contrário um atacante pode escolhê-lo.

Notas de segurança

• Os tokens são credenciais. Quem tiver um token de acesso válido pode normalmente agir como o seu dono até ele expirar. Esta ferramenta descodifica e verifica tudo no teu navegador e nunca envia o token nem a chave para lado nenhum. Mesmo assim, evita colar tokens de produção em ferramentas que não consegues inspecionar.
• alg: none significa que o token não está assinado. Qualquer pessoa o pode forjar, e um servidor tem de o rejeitar. A ferramenta mostra um aviso e recusa-se a «verificar» um token assim.
• As verificações de tempo usam o relógio do teu computador, sem margem de tolerância; os servidores costumam aceitar um ou dois minutos de diferença de relógio.
• As datas JWT (NumericDate) são segundos desde 1 de janeiro de 1970 UTC. Um valor com 13 algarismos está provavelmente em milissegundos, um erro frequente.