Sessão em cookie httpOnly ou JWT em localStorage: o que escolher para uma aplicação web
A questão foi colocada de forma imprecisa
O debate cookie vs JWT confunde duas soluções independentes:
- 1.Onde o cliente armazena o token: cookie httpOnly, que o próprio navegador envia, ou
localStorage, de onde o JavaScript o lê e o coloca no cabeçalhoAuthorization. - 2.O que é este token: um identificador de sessão opaco pelo qual o servidor encontra uma entrada no banco de dados ou um JWT assinado autossuficiente.
O JWT pode ser armazenado em um cookie httpOnly e o ID da sessão em localStorage. Portanto, analisaremos cada solução separadamente.
Onde armazenar: consequências XSS
Se o script de outra pessoa foi executado na página (dependência vulnerável, entrada do usuário sem escape, script de análise comprometido):
- Token em `localStorage` o script irá ler e enviar para seu servidor. O invasor usa a sessão de sua máquina enquanto o token é válido, mesmo depois que a vítima fecha a aba.
- O token no cookie httpOnly não pode ser lido pelo script. Ele pode enviar solicitações em nome do usuário enquanto a página está aberta – o XSS continua sendo uma vulnerabilidade séria. Mas você não pode roubar uma sessão e levá-la com você.
A diferença não é se o cookie “protege contra XSS” (não protege), mas a extensão do dano. Para uma aplicação web onde o frontend e a API estão no mesmo site, isso resolve o problema em favor dos cookies.
Preço do cookie: CSRF
O navegador envia cookies automaticamente, inclusive para solicitações iniciadas por outro site. Proteção em várias camadas:
SameSite=Lax(padrão nos navegadores Chromium, mas definido explicitamente) não envia cookies com solicitações POST entre sites.- Para modificar solicitações, o servidor verifica o cabeçalho
Origine rejeita solicitações de origem estrangeira. - Mudanças de estado - somente usando métodos POST/PUT/PATCH/DELETE, nunca GET.
As ações do servidor em Next.js verificam Origin elas mesmas; Para seus próprios Route Handlers, você preenche o cheque.
O que armazenar: recall de sessão
O servidor verifica o JWT assinado sem acessar o banco de dados. A desvantagem: não pode ser revogado antes da data de vencimento. O usuário clicou em “sair de todos os dispositivos”, o administrador bloqueou a conta, o token roubado foi detectado - o JWT continua funcionando. Soluções alternativas (vida útil curta mais token de atualização, lista revogada) retornam o acesso ao armazenamento, para o qual o JWT foi escolhido como ausente.
A sessão do servidor é uma entrada em uma tabela. Revogação - exclusão de uma linha, com efeito imediato. Um acesso ao banco de dados por solicitação é invisível para a maioria dos aplicativos e é armazenado em cache, se necessário.
Implementação de uma sessão de servidor
CREATE TABLE sessions ( id_hash bytea PRIMARY KEY, user_id uuid NOT NULL REFERENCES users(id) ON DELETE CASCADE, expires_at timestamptz NOT NULL, created_at timestamptz NOT NULL DEFAULT now(), user_agent text ); CREATE INDEX sessions_user_idx ON sessions (user_id);
// lib/auth/sessions.ts
import "server-only";
import { createHash, randomBytes } from "node:crypto";
import { cookies } from "next/headers";
import { db } from "@/lib/db";
const COOKIE = "__Host-session";
const TTL_DAYS = 30;
const sha256 = (s: string) => createHash("sha256").update(s).digest();
export async function createSession(userId: string, userAgent?: string) {
const token = randomBytes(32).toString("base64url");
const expires = new Date(Date.now() + TTL_DAYS * 86_400_000);
await db.query(
"INSERT INTO sessions (id_hash, user_id, expires_at, user_agent) VALUES ($1, $2, $3, $4)",
[sha256(token), userId, expires, userAgent?.slice(0, 200) ?? null]
);
const jar = await cookies();
jar.set(COOKIE, token, {
httpOnly: true, secure: true, sameSite: "lax", path: "/", expires,
});
}
export async function currentUserId(): Promise<string | null> {
const token = (await cookies()).get(COOKIE)?.value;
if (!token) return null;
const { rows } = await db.query(
"SELECT user_id FROM sessions WHERE id_hash = $1 AND expires_at > now()",
[sha256(token)]
);
return rows[0]?.user_id ?? null;
}
export async function destroySession() {
const jar = await cookies();
const token = jar.get(COOKIE)?.value;
if (token) await db.query("DELETE FROM sessions WHERE id_hash = $1", [sha256(token)]);
jar.set(COOKIE, "", { httpOnly: true, secure: true, sameSite: "lax", path: "/", maxAge: 0 });
}Detalhes principais:
- O banco de dados possui um hash, não um token. O vazamento de um dump ou o acesso somente leitura à tabela não fornece sessões prontas.
- 32 bytes aleatórios de um gerador criptográfico - força bruta não é possível, não é necessária assinatura.
- Nova sessão após login, em vez de aumentar os direitos da antiga. Caso contrário, a fixação da sessão é possível: o invasor passa seu identificador para a vítima antes de fazer login.
- `cookies()` é assíncrono em Next.js 15, portanto
await. Você pode definir cookies em Ações do Servidor e Manipuladores de Rota, mas não ao renderizar o componente do servidor.
“Sair em todos os dispositivos” - DELETE FROM sessions WHERE user_id = $1. Uma lista de sessões ativas com user_agent e data é um bônus grátis deste esquema.
Quando o token no cabeçalho é justificado
- Aplicativo móvel ou CLI. Os cookies são inconvenientes lá, o token é armazenado no armazenamento seguro da plataforma (Keychain, Keystore), e não em
localStorage. - API para clientes de terceiros. Eles recebem chaves separadas ou tokens OAuth com direitos limitados.
- Chamadas entre serviços. O JWT de curta duração entre seus serviços é conveniente precisamente porque é verificado sem uma base comum.
Erros frequentes
- Atualize o token em
localStoragequando o token de acesso tiver vida curta. Um token de atualização roubado oferece acesso de longo prazo – todos os benefícios de curto prazo são perdidos. Domain=.example.compara cookies de sessão desnecessariamente. Qualquer subdomínio, incluindo uma landing page vulnerável, irá recebê-lo. O prefixo__Host-desabilita o atributoDomaine fecha esta opção.- Verificando
exppara JWT sem verificação de assinatura ou com o algoritmo do cabeçalho do token. Grave o algoritmo no servidor.
Resumo
Para uma aplicação web com backend próprio: identificador opaco no cookie httpOnly, registros de sessão no banco de dados, SameSite=Lax e verificação Origin. JWT e cabeçalho Authorization - para clientes não navegadores e para comunicação entre serviços.