Сессия в httpOnly cookie или JWT в localStorage: что выбрать для веб-приложения
Вопрос поставлен неточно
Спор «cookie против JWT» смешивает два независимых решения:
- 1.Где клиент хранит токен: httpOnly cookie, которую браузер отправляет сам, или
localStorage, откуда его читает JavaScript и кладёт в заголовокAuthorization. - 2.Что это за токен: непрозрачный идентификатор сессии, по которому сервер находит запись в базе, или самодостаточный подписанный JWT.
JWT можно хранить в httpOnly cookie, а идентификатор сессии — в localStorage. Поэтому разберём каждое решение отдельно.
Где хранить: последствия XSS
Если на странице выполнился чужой скрипт (уязвимая зависимость, неэкранированный пользовательский ввод, скомпрометированный скрипт аналитики):
- Токен в `localStorage` скрипт прочитает и отправит на свой сервер. Атакующий пользуется сессией со своей машины, пока токен действует, даже после того как жертва закрыла вкладку.
- Токен в httpOnly cookie скрипт прочитать не может. Он может отправлять запросы от имени пользователя, пока открыта страница, — XSS остаётся серьёзной уязвимостью. Но украсть сессию и унести её с собой нельзя.
Разница не в том, «защищает ли cookie от XSS» (не защищает), а в масштабе ущерба. Для веб-приложения, где фронтенд и API на одном сайте, это решает вопрос в пользу cookie.
Цена cookie: CSRF
Браузер отправляет cookie автоматически, в том числе на запросы, инициированные чужим сайтом. Защита в несколько слоёв:
SameSite=Lax(значение по умолчанию в Chromium-браузерах, но задавайте явно) не отправляет cookie с межсайтовыми POST-запросами.- Для изменяющих запросов сервер проверяет заголовок
Originи отклоняет запросы с чужого источника. - Изменения состояния — только методами POST/PUT/PATCH/DELETE, никогда GET.
Server Actions в Next.js проверяют Origin сами; для собственных Route Handlers проверку пишете вы.
Что хранить: отзыв сессии
Подписанный JWT сервер проверяет без обращения к базе. Обратная сторона: его нельзя отозвать до истечения срока. Пользователь нажал «выйти на всех устройствах», администратор заблокировал аккаунт, украденный токен обнаружен — JWT продолжает работать. Обходные пути (короткий срок жизни плюс refresh-токен, список отозванных) возвращают обращение к хранилищу, ради отсутствия которого JWT выбирали.
Серверная сессия — запись в таблице. Отзыв — удаление строки, действует немедленно. Одно обращение к базе на запрос для большинства приложений незаметно, а при необходимости кэшируется.
Реализация серверной сессии
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 });
}Ключевые детали:
- В базе хеш, а не токен. Утечка дампа или read-only доступ к таблице не дают готовых сессий.
- 32 случайных байта из криптографического генератора — перебор невозможен, подпись не нужна.
- Новая сессия при входе, а не повышение прав старой. Иначе возможна фиксация сессии: атакующий подсовывает жертве свой идентификатор до входа.
- `cookies()` асинхронна в Next.js 15, отсюда
await. Устанавливать cookie можно в Server Actions и Route Handlers, но не при рендере серверного компонента.
«Выйти на всех устройствах» — DELETE FROM sessions WHERE user_id = $1. Список активных сессий с user_agent и датой — бесплатный бонус этой схемы.
Когда токен в заголовке оправдан
- Мобильное приложение или CLI. Cookie там неудобны, токен хранится в защищённом хранилище платформы (Keychain, Keystore), а не в
localStorage. - API для сторонних клиентов. Им выдаются отдельные ключи или OAuth-токены с ограниченными правами.
- Межсервисные вызовы. Короткоживущий JWT между вашими сервисами удобен именно тем, что проверяется без общей базы.
Частые ошибки
- Refresh-токен в
localStorageпри короткоживущем access-токене. Украденный refresh-токен даёт долгий доступ — вся выгода короткого срока теряется. Domain=.example.comу cookie сессии без необходимости. Любой поддомен, включая уязвимый лендинг, получит её. Префикс__Host-запрещает атрибутDomainи закрывает этот вариант.- Проверка
expу JWT без проверки подписи или с алгоритмом из заголовка токена. Алгоритм фиксируйте на сервере.
Итог
Для веб-приложения с собственным бэкендом: непрозрачный идентификатор в httpOnly cookie, записи сессий в базе, SameSite=Lax и проверка Origin. JWT и заголовок Authorization — для клиентов, которые не являются браузером, и для связи между сервисами.