Sessões, JWT e OAuth 2.0
Como manter alguém autenticado e como delegar acesso a outra aplicação, com as armadilhas de cada abordagem.
10 min de leitura · Intermediário · Revisado em
Duas perguntas diferentes
- Autenticação
- Quem é você? Confirmar a identidade com senha, código, chave de acesso ou um provedor externo.
- Autorização
- O que você pode fazer? Decidir, a cada requisição, se aquela pessoa pode ler ou alterar aquele recurso.
O HTTP não guarda memória entre requisições. Depois do login, a aplicação precisa de uma forma de reconhecer a pessoa nas próximas chamadas. As duas mais comuns são uma sessão no servidor e um token carregado pelo cliente.
Sessão com cookie
Login com sessão guardada no servidor
- Navegador → Servidor: POST /login. E-mail e senha, por HTTPS.
- Servidor → Servidor: Confere o hash da senha
- Servidor → Armazém de sessões: Cria a sessão. Um id aleatório ligado ao usuário.
- Servidor → Navegador: 200 + Set-Cookie. O cookie leva só o id da sessão.
- Navegador → Servidor: GET /perfil. O navegador envia o cookie sozinho.
- Servidor → Armazém de sessões: Busca a sessão pelo id
- Servidor → Navegador: 200 OK
Set-Cookie: sid=3f9a1c…; HttpOnly; Secure; SameSite=Lax; Path=/; Max-Age=86400HttpOnly- O JavaScript da página não consegue ler o cookie. Um script injetado não rouba a sessão.
Secure- O cookie só viaja por HTTPS.
SameSite=Lax- O cookie não acompanha requisições disparadas por outros sites, o que reduz ataques de CSRF.
Tokens JWT
Um JWT (JSON Web Token) carrega os dados da pessoa dentro do próprio token, com uma assinatura. O servidor confere a assinatura e a validade sem consultar um banco.
Cabeçalho, conteúdo e assinatura, separados por ponto
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9
.eyJzdWIiOiI0MiIsInJvbGUiOiJhbHVubyIsImV4cCI6MTc5ODc2MTYwMH0
.assinatura…{ "alg": "HS256", "typ": "JWT" }
{ "sub": "42", "role": "aluno", "exp": 1798761600 }- Valide sempre assinatura, algoritmo esperado,
exp,isseaud. Rejeitealg: none. - Use validade curta para o token de acesso e um refresh token para renovar.
- No navegador, prefira guardar o token em um cookie
HttpOnly. EmlocalStorage, qualquer script da página consegue lê-lo.
| Sessão no servidor | JWT | |
|---|---|---|
| Onde fica o estado | No servidor | No próprio token |
| Encerrar o acesso agora | Simples: apague a sessão | Difícil: o token vale até expirar |
| Vários serviços | Precisam do mesmo armazém de sessões | Cada um valida a assinatura sozinho |
| Bom para | Aplicações web no mesmo domínio | APIs, apps mobile, comunicação entre serviços |
OAuth 2.0: delegar acesso
OAuth 2.0 resolve outro problema: permitir que uma aplicação acesse algo em seu nome, sem receber sua senha. É o que acontece quando um app pede acesso ao seu calendário. O botão "Entrar com Google" usa o OpenID Connect, uma camada sobre o OAuth que também informa quem é você.
Fluxo Authorization Code com PKCE, o recomendado hoje
- Aplicação → Navegador: Redireciona para /authorize. Com
client_id,scope,stateecode_challenge. - Navegador → Autorização: Abre a página de login
- Autorização → Autorização: Login e consentimento. A pessoa vê o que está autorizando.
- Autorização → Navegador: Volta com ?code=…. Um código de uso único.
- Navegador → Aplicação: Entrega o código
- Aplicação → Autorização: POST /token. Código +
code_verifier. - Autorização → Aplicação: access_token. E, opcionalmente, um refresh token.
- Aplicação → API: Authorization: Bearer …. Só no escopo autorizado.
- Escopo
- O que a aplicação pode fazer, como
calendar.read. Peça só o necessário. state- Valor aleatório que volta no redirecionamento. Confirma que a resposta é para o pedido que você fez.
- PKCE
- A aplicação cria um segredo de uso único e envia só o hash dele no início. Quem interceptar o código não consegue trocá-lo por um token.
Qual usar no seu projeto
| Cenário | Abordagem |
|---|---|
| Aplicação web e API no mesmo domínio | Sessão com cookie HttpOnly |
| App mobile ou API usada por terceiros | Tokens de acesso curtos via OAuth 2.0 |
| "Entrar com Google ou GitHub" | OpenID Connect |
| Um serviço chamando outro | Client credentials ou certificados (mTLS) |