Сесія в 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 — для клієнтів, які не є браузером, та для зв'язку між сервісами.