Práticas recomendadas para uma implementação segura de JWT

Os JWTs só são tão seguros quanto sua implementação. A especificação é flexível; essa flexibilidade cria vulnerabilidades. Siga estas práticas recomendadas para evitar as armadilhas comuns que levaram a contornos de autenticação em sistemas de produção.

Sempre especifique explicitamente o algoritmo esperado: jwt.decode(token, key, algorithms=["RS256"]). Nunca leia o algoritmo do cabeçalho do token para selecionar a chave de verificação ou o caminho de código. Isso impede ataques alg=none e de confusão de chaves.

Tokens de acesso: 15–60 minutos. Tokens de atualização: 7–30 dias, armazenados em cookies httpOnly (não em localStorage). Quando o token expira, o cliente usa o token de atualização para obter um novo token de acesso do servidor de autenticação, sem nova autenticação.

Valide aud (público) para garantir que o token foi emitido para o seu serviço, não para outro. Valide iss (emissor) em relação à URL do seu servidor de autenticação. Sem essas verificações, um token de outro aplicativo assinado com a mesma chave seria aceito.

Tokens de acesso na memória (variável JS) — apagados ao fechar a aba. Tokens de atualização em cookies httpOnly, Secure, SameSite=Strict — inacessíveis ao JavaScript. Nunca armazene JWTs em localStorage — XSS pode roubá-los.

Os JWTs não mantêm estado — não há revogação integrada. Opções: manter uma lista de revogação (lista de bloqueio) verificada em cada solicitação; usar uma expiração muito curta; usar tokens opacos com uma consulta centralizada em contextos de alta segurança.

Faça a rotação das chaves de assinatura regularmente. Publique várias chaves no JWKS com valores de kid diferentes. Durante a rotação: emita novos tokens com o novo kid, mantenha a chave antiga ativa até os tokens antigos expirarem e, depois, remova a chave antiga do JWKS.

Nunca coloque dados sensíveis (senhas, números de seguridade social, cartões de crédito) na carga útil do JWT — ela é codificada em base64url, não criptografada. Use JWE (JSON Web Encryption) se precisar de declarações criptografadas ou mantenha os dados sensíveis no servidor.

Transmita JWTs somente por HTTPS. Um JWT interceptado por HTTP permite o contorno completo da autenticação. Defina a flag Secure nos cookies. Use HSTS para impedir a redução do protocolo. Nunca registre strings completas de JWT nos registros do servidor.

Use bibliotecas bem mantidas: PyJWT 2+, python-jose, auth0/node-jsonwebtoken 9+, Nimbus JOSE + JWT (Java). Evite implementar a verificação de JWT do zero. Consulte regularmente os bancos de dados de CVE em busca de vulnerabilidades nas bibliotecas.

Teste todos os vetores de ataque: envie um token alg=none, um token de confusão RS256→HS256, um token expirado, um token com o público incorreto e uma carga útil adulterada. Use jwt.io para criar tokens de teste. Adicione testes de integração que confirmem que eles são rejeitados com 401.

Onde os tokens de atualização devem ser armazenados em um aplicativo web?

O uso seguro de JWT exige algoritmos fixados, expiração curta dos tokens de acesso, armazenamento dos tokens de atualização em cookies httpOnly, validação de público e emissor e rotação de chaves. Próximo: esquemas criptográficos de compartilhamento de segredos.