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.
  • decode não é verify. Token sem assinatura tem de dar 401.
  • 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 HttpOnly no lugar do localStorage.

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.

← Todos os posts