JWT mal configurado: 4 erros que transformam o token de login em chave mestra

O login funciona, a tela só abre para quem entrou, o token vai em todo pedido. Parece resolvido. O JWT é justamente a parte do app que parece mais resolvida do que está, porque quase todos os erros dele são invisíveis para quem usa.
Antes: o que tem dentro de um JWT
São três pedaços separados por ponto: cabeçalho.conteúdo.assinatura. Os dois
primeiros são só base64, não criptografia. Qualquer pessoa com o token lê
o que tem dentro. Faça o teste no console do navegador, com um token seu:
const token = "cole_o_token_aqui"
JSON.parse(atob(token.split(".")[1].replace(/-/g, "+").replace(/_/g, "/")))
Quem protege o token é a assinatura: o servidor confere se o conteúdo foi assinado pela chave dele. Se essa conferência falha, ou não acontece, o resto não importa.
1. O servidor lê o token sem conferir a assinatura
É o erro mais grave e o mais fácil de gerar. Toda biblioteca de JWT tem duas funções parecidas: uma decodifica (só lê) e outra verifica (lê e confere a assinatura). Usar a primeira no lugar da segunda deixa o código funcionando, só que ele passa a aceitar qualquer token.
// errado: lê o conteúdo e confia nele
const usuario = jwt.decode(token)
// certo: confere a assinatura e o algoritmo antes de confiar
const usuario = jwt.verify(token, process.env.JWT_SECRET, {
algorithms: ["HS256"],
})
Uma variação do mesmo erro é aceitar "alg": "none", o token que declara não
ter assinatura. As bibliotecas atuais recusam isso por padrão. O problema
aparece em código que monta a verificação à mão ou que não fixa a lista de
algoritmos.
Como testar no seu app: monte um token sem assinatura e veja se uma rota protegida aceita.
h=$(printf '{"alg":"none","typ":"JWT"}' | base64 | tr -d '=' | tr '/+' '_-')
p=$(printf '{"sub":"SEU_ID"}' | base64 | tr -d '=' | tr '/+' '_-')
curl -i -H "Authorization: Bearer $h.$p." https://seuapp.com.br/api/me
O esperado é 401. Se vier 200 com os seus dados, qualquer pessoa entra
como qualquer usuário, bastando escrever o id dele no token.
2. O segredo é fraco
No HS256, a mesma chave assina e confere. Se ela for secret, 123456, o
nome do projeto ou o exemplo que veio no tutorial, dá para descobrir a chave
fora do seu servidor: basta um token válido e um programa de força bruta, sem
nenhum pedido ao seu app e sem deixar rastro no seu log. Com a chave na mão,
quem a descobriu assina o token que quiser.
O conserto é uma chave longa e aleatória, gerada e não escrita à mão:
openssl rand -base64 48
Ela vai para a variável de ambiente do servidor, nunca para o código e nunca
com prefixo público (NEXT_PUBLIC_, VITE_). Se a chave antiga já esteve no
repositório, troque: todo token emitido com ela continua valendo até ela mudar.
3. O token nunca vence
Um JWT sem o campo exp vale para sempre. Sair da conta só apaga o token do
seu navegador; a cópia que vazou (num log, num print, num computador
emprestado) continua abrindo a conta.
jwt.sign({ sub: usuario.id }, process.env.JWT_SECRET, { expiresIn: "15m" })
Token curto e um refresh token guardado no servidor é o arranjo comum: o token de acesso vence logo, e a sessão pode ser encerrada de verdade, porque o servidor consegue invalidar o refresh.
4. O token carrega o que não devia
Como o conteúdo é legível, tudo o que vai nele está exposto a quem tiver o token. Aparece de tudo: senha (mesmo com hash), CPF, chave de API, o plano e o limite de crédito do cliente.
A regra é pôr o mínimo para identificar a pessoa (o id) e buscar o resto no
banco quando precisar. Se um campo do token decide o que o usuário pode fazer,
como role ou plano, ele só vale se a assinatura for conferida. Volte ao
erro 1.
E onde o token fica guardado
localStorage.setItem("token", ...) é o padrão que quase todo gerador de
código escreve, porque funciona de primeira. O efeito colateral: qualquer
script que rode na página lê o token, inclusive um script injetado por uma
falha de XSS ou por uma dependência comprometida.
A alternativa é o servidor gravar o token num cookie HttpOnly, Secure e
SameSite=Lax. O JavaScript da página não consegue ler esse cookie, e o
navegador o envia sozinho. Se você usa Supabase Auth, Clerk ou Auth.js, boa
parte disto já vem resolvida. O risco está no login que a IA escreveu do zero.
O resumo
- O conteúdo do JWT é legível por qualquer um. A assinatura é a única proteção, então ela precisa ser verificada, com algoritmo fixo.
decodenão éverify. Token sem assinatura tem de dar401.- Segredo curto ou de exemplo é quebrado fora do seu servidor. Gere com
openssl rand. - Sem
exp, sair da conta não encerra nada. - Nada no token que você não publicaria. E, se der, cookie
HttpOnlyno lugar dolocalStorage.
Token conferido do jeito certo ainda não basta se a rota não pedir o token, ou se devolver o registro de outra conta. As duas pontas estão em API sem autenticação e IDOR: o que é.
No ShieldScan, o JWT está no Scan Padrão (3 créditos). A troca de algoritmo fica no Completo (5).
Token mal conferido é um dos pontos que mais falham em app feito com IA. Os outros, e como testar cada um, estão em App feito com IA é vulnerável? 5 pontos para testar.
