Sessie in httpOnly cookie of JWT in localStorage: wat te kiezen voor een webapplicatie
De vraag is onjuist gesteld
Het cookie versus JWT-debat verwart twee onafhankelijke oplossingen:
- 1.Waar de client de token opslaat: httpOnly cookie, die de browser zelf verzendt, of
localStorage, vanwaar JavaScript het leest en in deAuthorizationheader plaatst. - 2.Wat is dit token: een ondoorzichtige sessie-ID waarmee de server een vermelding in de database vindt, of een zelfvoorzienend ondertekende JWT.
De JWT kan worden opgeslagen in een httpOnly-cookie en de sessie-ID in localStorage. Daarom zullen we elke oplossing afzonderlijk analyseren.
Waar op te slaan: XSS-gevolgen
Als het script van iemand anders op de pagina is uitgevoerd (kwetsbare afhankelijkheid, gebruikersinvoer zonder escapecodes, gecompromitteerd analysescript):
- Token in `localStorage` dat het script leest en naar de server verzendt. De aanvaller gebruikt de sessie van zijn machine zolang het token geldig is, zelfs nadat het slachtoffer het tabblad heeft gesloten.
- Het token in de httpOnly cookie kan niet door het script worden gelezen. Het kan namens de gebruiker verzoeken verzenden terwijl de pagina geopend is - XSS blijft een ernstige kwetsbaarheid. Maar je kunt geen sessie stelen en meenemen.
Het verschil is niet of de cookie ‘beschermt tegen XSS’ (dat doet hij niet), maar de omvang van de schade. Voor een webapplicatie waarbij de frontend en API zich op dezelfde site bevinden, lost dit het probleem op ten gunste van cookies.
Koekjesprijs: CSRF
De browser verzendt automatisch cookies, ook naar verzoeken die door een andere site worden geïnitieerd. Bescherming in verschillende lagen:
SameSite=Lax(standaard in Chromium-browsers, maar expliciet ingesteld) verzendt geen cookies met cross-site POST-verzoeken.- Voor het wijzigen van verzoeken controleert de server de header
Originen wijst verzoeken van buitenlandse oorsprong af. - Statuswijzigingen - alleen met behulp van POST/PUT/PATCH/DELETE-methoden, nooit GET.
Serveracties in Next.js controleren Origin zelf; Voor uw eigen Routebehandelaars schrijft u de cheque uit.
Wat op te slaan: sessieherinnering
De server verifieert de ondertekende JWT zonder toegang te krijgen tot de database. Het nadeel: het kan niet vóór de vervaldatum worden ingetrokken. De gebruiker klikte op "uitloggen op alle apparaten", de beheerder blokkeerde het account, het gestolen token werd gedetecteerd - JWT blijft werken. Tijdelijke oplossingen (korte levensduur plus vernieuwingstoken, ingetrokken lijst) geven toegang tot de opslag, waarvoor de JWT als ontbrekend werd gekozen.
Serversessie is een vermelding in een tabel. Intrekking - het verwijderen van een regel, met onmiddellijke ingang. Eén toegang tot de database per aanvraag is voor de meeste applicaties onzichtbaar en wordt indien nodig in de cache opgeslagen.
Implementatie van een serversessie
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 });
}Belangrijkste details:
- De database heeft een hash, geen token. Het lekken van een dump of alleen-lezen toegang tot de tabel levert geen kant-en-klare sessies op.
- 32 willekeurige bytes van een cryptografische generator - brute kracht is niet mogelijk, geen handtekening vereist.
- Nieuwe sessie bij inloggen, in plaats van de rechten van de oude te vergroten. Anders is sessiefixatie mogelijk: de aanvaller geeft zijn identificatie door aan het slachtoffer voordat hij inlogt.
- `cookies()` is asynchroon in Next.js 15, vandaar
await. U kunt cookies instellen in Serveracties en Routehandlers, maar niet bij het weergeven van de servercomponent.
“Uitloggen op alle apparaten” - DELETE FROM sessions WHERE user_id = $1. Een lijst met actieve sessies met user_agent en datum is een gratis bonus van dit schema.
Wanneer het token in de header gerechtvaardigd is
- Mobiele applicatie of CLI. Cookies zijn daar lastig, het token wordt opgeslagen in de beveiligde opslag van het platform (Keychain, Keystore) en niet in
localStorage. - API voor clients van derden. Ze krijgen afzonderlijke sleutels of OAuth-tokens met beperkte rechten.
- Interservicegesprekken. Kortstondige JWT tussen uw diensten is handig, juist omdat deze wordt geverifieerd zonder een gemeenschappelijke basis.
Frequente fouten
- Vernieuw het token in
localStoragewanneer het toegangstoken van korte duur is. Een gestolen vernieuwingstoken geeft toegang op de lange termijn - alle voordelen op de korte termijn gaan verloren. Domain=.example.comvoor onnodige sessiecookies. Elk subdomein, inclusief een kwetsbare landingspagina, zal het ontvangen. Het voorvoegsel__Host-schakelt het kenmerkDomainuit en sluit deze optie.- Controleren van
expop JWT zonder handtekeningverificatie of met het algoritme uit de tokenheader. Registreer het algoritme op de server.
Samenvatting
Voor een webapplicatie met een eigen backend: ondoorzichtige identifier in httpOnly cookie, sessierecords in de database, SameSite=Lax en vink Origin aan. JWT en header Authorization - voor niet-browserclients en voor communicatie tussen services.