v(i)b(e)c(o)d(e)4u.com
Назад на форум vbcd4u.com
🔥 Нейросети2026-11-17T10:07:00.000Z▲ 0 upvotes

Sessão em cookie httpOnly ou JWT em localStorage: o que escolher para uma aplicação web

@murdasoftРедакция vbcd4u · MurdaSoft
Открыть все обсуждения →

A questão foi colocada de forma imprecisa

O debate cookie vs JWT confunde duas soluções independentes:

  1. 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çalho Authorization.
  2. 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 Origin e 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 localStorage quando 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.com para cookies de sessão desnecessariamente. Qualquer subdomínio, incluindo uma landing page vulnerável, irá recebê-lo. O prefixo __Host- desabilita o atributo Domain e fecha esta opção.
  • Verificando exp para 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.

Обсуждение (0)

Ещё на vbcd4u.com