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

  1. Navegador → Servidor: POST /login. E-mail e senha, por HTTPS.
  2. Servidor → Servidor: Confere o hash da senha
  3. Servidor → Armazém de sessões: Cria a sessão. Um id aleatório ligado ao usuário.
  4. Servidor → Navegador: 200 + Set-Cookie. O cookie leva só o id da sessão.
  5. Navegador → Servidor: GET /perfil. O navegador envia o cookie sozinho.
  6. Servidor → Armazém de sessões: Busca a sessão pelo id
  7. Servidor → Navegador: 200 OK
Set-Cookie: sid=3f9a1c…; HttpOnly; Secure; SameSite=Lax; Path=/; Max-Age=86400
HttpOnly
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, iss e aud. Rejeite alg: 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. Em localStorage, qualquer script da página consegue lê-lo.
Sessão ou JWT
Sessão no servidorJWT
Onde fica o estadoNo servidorNo próprio token
Encerrar o acesso agoraSimples: apague a sessãoDifícil: o token vale até expirar
Vários serviçosPrecisam do mesmo armazém de sessõesCada um valida a assinatura sozinho
Bom paraAplicações web no mesmo domínioAPIs, 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

  1. Aplicação → Navegador: Redireciona para /authorize. Com client_id, scope, state e code_challenge.
  2. Navegador → Autorização: Abre a página de login
  3. Autorização → Autorização: Login e consentimento. A pessoa vê o que está autorizando.
  4. Autorização → Navegador: Volta com ?code=…. Um código de uso único.
  5. Navegador → Aplicação: Entrega o código
  6. Aplicação → Autorização: POST /token. Código + code_verifier.
  7. Autorização → Aplicação: access_token. E, opcionalmente, um refresh token.
  8. 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

Pontos de partida razoáveis
CenárioAbordagem
Aplicação web e API no mesmo domínioSessão com cookie HttpOnly
App mobile ou API usada por terceirosTokens de acesso curtos via OAuth 2.0
"Entrar com Google ou GitHub"OpenID Connect
Um serviço chamando outroClient credentials ou certificados (mTLS)

Referências

Trilhas relacionadas