<\> Casa do Dev
Notícias abrir
Ferramentas abrir
Vagas abrir
Aprender abrir
Comunidade abrir
Guia de Compras abrir

JWT explicado: como funcionam os tokens

DA

6 min

JWT explicado: como funcionam os tokens

Entenda JWT: as três partes do token, a assinatura que dá confiança, o que nunca colocar no payload e quando sessão resolve melhor.

Neste artigo

Depois do login, muita API devolve um token curto, com três blocos de texto separados por ponto. Esse é o JWT, o formato de token que carrega informação dentro de si e carrega uma assinatura que o servidor confia. Entender a montagem do token explica por que ele funciona, e também por que ele vira problema quando usado do jeito errado.

JWT é um token em três partes codificadas, header, payload e assinatura. O servidor assina o conjunto com segredo ou chave, e qualquer alteração quebra a assinatura. Por isso ele confia no conteúdo sem consultar banco, e por isso o payload, que é legível por qualquer um, nunca pode carregar dado sensível. A base de autenticação por trás disso está no guia de cibersegurança para iniciantes.

Do que um JWT é feito?

De três blocos em codificação de base64url: o header declara o algoritmo e o tipo, o payload carrega as afirmações, como identificador do usuário e validade, e a assinatura fecha o conjunto. Os dois primeiros são apenas codificados, não criptografados: qualquer pessoa decodifica e lê. A assinatura é o terceiro bloco, calculada com segredo que só o servidor tem, e é ela que impede a alteração silenciosa do conteúdo.

eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiI4MjEiLCJyb2xlIjoiY2xpZW50ZSIsImV4cCI6MTc3MDAwMDAwMH0.7fK9

No exemplo, o payload decodifica para identificador, papel e validade. Decodifique o seu próprio token de teste no site de depuração do JWT e a estrutura fica evidente em segundos.

Por que o servidor confia no token?

Porque a assinatura amarra o conteúdo. Ao receber o token, o servidor recalcula a assinatura com o mesmo segredo e compara: se o payload foi alterado por quem não tem o segredo, o cálculo não bate e o token é rejeitado. Essa verificação é local e rápida, sem consulta a banco nem memória de sessão, e é essa propriedade que faz o JWT caber bem em API distribuída, onde vários serviços precisam validar acesso sem compartilhar sessão.

⚠️ Atenção: codificado não é escondido. Qualquer pessoa que receber o token lê o payload decodificando os dois primeiros blocos. Papel, identificador e validade são aceitáveis, e-mail, documento e dado sensível não são.

Expiração e refresh na prática

O token de acesso vive pouco, minutos em sistemas exigentes, e essa validade vai declarada no payload. Quando expira, o cliente apresenta o refresh token, credencial de vida mais longa guardada no servidor, e recebe acesso novo sem novo login. A divisão limita o estrago: token roubado vale pouco porque vence rápido, e o refresh, que vale mais, pode ser revogado porque tem estado no servidor.

O problema da revogação

A propriedade que dá escala ao JWT também cria o problema mais citado: token válido não pode ser cancelado facilmente, porque o servidor não guarda lista de sessões. As saídas práticas são vida curta do token de acesso e lista de revogação para casos críticos. O cenário de token roubado, que o ataque ao setor financeiro brasileiro ilustra, é o argumento mais forte para vida curta.

JWT ou sessão tradicional?

A escolha depende de escala e de necessidade de revogação, e a comparação direta ajuda a decidir.

AspectoSessãoJWT
Estado no servidorGuarda a sessãoNão guarda
RevogaçãoImediataDepende de vida curta
Custo por requisiçãoConsulta ao armazenamentoVerificação local
Cabe bem emAplicação web únicaAPI e serviços distribuídos

Nenhum dos dois é resposta universal, e sistemas reais misturam: sessão na interface, JWT nas fronteiras entre serviços. Para quem segue a trilha de segurança, o curso de analista de cibersegurança júnior da Cisco cobre autenticação nesse nível de detalhe.

Quando o sistema cresce, o kid no header e a rotação regular de chaves separam os projetos amadores dos confiáveis. O kid permite trocar a chave sem deslogar ninguém, aposentando a antiga com janela de sobreposição. Sem revogação projetada, o token vazado é um problema sem solução limpa, e as compensações de refresh curto existem para limitar esse dano.

Os erros de implementação que abrem as portas

O erro mais caro é aceitar o token sem validar a assinatura, confiando no fato de que ele existe e veio em uma requisição. Validação é sempre local, com a chave pública própria, conferindo assinatura, expiração e o emissor esperado. O segundo erro é guardar dado sensível no payload, já que o corpo do token é apenas codificado, e nunca criptografado: qualquer pessoa com acesso à string lê o conteúdo em segundos. O terceiro é usar algoritmo none ou deixar o próprio token declarar o algoritmo da verificação, brecha clássica já explorada em sistemas reais.

Esses erros compartilham uma raiz: tratar o token como senha que o servidor confia, e não como afirmação que o servidor verifica. A mudança de mentalidade resolve a maior parte da lista de uma vez. Para o contexto de ameaças que torna essa disciplina obrigatória, o guia sobre ataques cibernéticos às empresas brasileiras em 2026 apresenta o mapa de riscos que o desenvolvimento de API moderno precisa ter em conta desde o primeiro endpoint.

Perguntas frequentes

Preciso criptografar o JWT?

O padrão mais comum é assinar, não criptografar, e por isso o payload é legível. Quando o conteúdo é sensível e precisa ficar opaco, existe o formato de JWE, que criptografa, mas a prática mais simples é manter dado sensível fora do token.

Onde guardar o token no navegador?

Em cookie com atributos de segurança, caminho restrito e proteção contra leitura por script. Armazenamento acessível por JavaScript amplia o estrago de um XSS, que vira roubo de sessão.

O que acontece se o segredo vazar?

Qualquer um passa a emitir token válido, e o sistema inteiro fica comprometido. O segredo vive em variável de ambiente ou cofre, fora do repositório, e a rotação é procedimento de emergência conhecido pelo time.

JWT elimina a necessidade de banco?

Elimina a consulta por requisição, porque a validação é local. Não elimina o banco do sistema, e o refresh token costuma ter estado persistido justamente para permitir revogação. A economia é na verificação, não no dado.

Qual o tempo de vida ideal do token?

O menor que não atrapalha a experiência, e sistemas exigentes trabalham na casa de minutos para o acesso, com refresh assumindo a continuidade. Vida curta é a compensação direta pela dificuldade de revogar.

O que você achou deste artigo?

Responda a Pergunta do Dia Teste seu conhecimento e mantenha sua streak. Crie seu Dev Card público Perfil dev compartilhável em um único link.

Vagas relacionadas

Ver todas as vagas →
DA

Escrito por

Dagmar

Atualizado em 06/10/2026 •

Ver perfil do autor

COMPARTILHAR