Sesi di cookie httpOnly atau JWT di Penyimpanan lokal: apa yang harus dipilih untuk aplikasi web
Pertanyaan yang diajukan tidak akurat
Perdebatan cookie vs JWT membingungkan dua solusi independen:
- 1.Tempat klien menyimpan token: cookie httpOnly, yang dikirimkan sendiri oleh browser, atau
localStorage, tempat JavaScript membacanya dan meletakkannya di headerAuthorization. - 2.Apa yang dimaksud dengan token ini: pengidentifikasi sesi buram yang digunakan server untuk menemukan entri dalam database, atau JWT bertanda tangan mandiri.
JWT dapat disimpan dalam cookie httpOnly dan ID sesi di localStorage. Oleh karena itu, kami akan menganalisis setiap solusi secara terpisah.
Tempat menyimpan: Konsekuensi XSS
Jika skrip orang lain dieksekusi pada laman (ketergantungan rentan, masukan pengguna tidak lolos, skrip analitik disusupi):
- Token di `localStorage` skrip akan dibaca dan dikirim ke servernya. Penyerang menggunakan sesi dari mesinnya saat token masih valid, bahkan setelah korban menutup tab.
- Token di cookie httpOnly tidak dapat dibaca oleh skrip. Itu dapat mengirim permintaan atas nama pengguna saat halaman terbuka - XSS tetap merupakan kerentanan yang serius. Tapi Anda tidak bisa mencuri satu sesi dan membawanya bersama Anda.
Perbedaannya bukan pada apakah cookie "melindungi terhadap XSS" (tidak), namun pada tingkat kerusakannya. Untuk aplikasi web yang frontend dan API berada di situs yang sama, hal ini menyelesaikan masalah dan mendukung cookie.
Harga kue: CSRF
Browser mengirimkan cookie secara otomatis, termasuk permintaan yang dilakukan oleh situs lain. Perlindungan dalam beberapa lapisan:
SameSite=Lax(default di browser Chromium, tetapi disetel secara eksplisit) tidak mengirimkan cookie dengan permintaan POST lintas situs.- Untuk memodifikasi permintaan, server memeriksa header
Origindan menolak permintaan dari luar negeri. - Perubahan status - hanya menggunakan metode POST/PUT/PATCH/DELETE, tidak pernah GET.
Tindakan Server di Next.js memeriksa Origin sendiri; Untuk Route Handler Anda sendiri, Anda menulis ceknya.
Apa yang harus disimpan: pemanggilan kembali sesi
Server memverifikasi JWT yang ditandatangani tanpa mengakses database. Kekurangannya: tidak dapat dicabut sebelum tanggal kadaluwarsanya. Pengguna mengklik "keluar di semua perangkat", administrator memblokir akun, token yang dicuri terdeteksi - JWT terus bekerja. Solusi (masa pakai singkat ditambah token penyegaran, daftar yang dicabut) mengembalikan akses ke penyimpanan, sehingga JWT dipilih untuk dihilangkan.
Sesi server adalah entri dalam tabel. Pencabutan - menghapus satu baris, berlaku segera. Satu akses ke database per permintaan tidak terlihat untuk sebagian besar aplikasi, dan di-cache jika diperlukan.
Implementasi sesi server
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 });
}Detail utama:
- Basis data memiliki hash, bukan token. Membocorkan akses dump atau hanya baca ke tabel tidak menyediakan sesi siap pakai.
- 32 byte acak dari generator kriptografi - kekerasan tidak dimungkinkan, tidak diperlukan tanda tangan.
- Sesi baru saat login, daripada menambah hak sesi lama. Jika tidak, fiksasi sesi mungkin terjadi: penyerang memberikan identitasnya kepada korban sebelum masuk.
- `cookies()` tidak sinkron di Next.js 15, oleh karena itu
await. Anda dapat mengatur cookie di Tindakan Server dan Penangan Rute, namun tidak saat merender komponen server.
“Keluar di semua perangkat” - DELETE FROM sessions WHERE user_id = $1. Daftar sesi aktif dengan user_agent dan tanggal adalah bonus gratis dari skema ini.
Ketika token di header dibenarkan
- Aplikasi seluler atau CLI. Cookie tidak nyaman di sana, token disimpan di penyimpanan aman platform (Keychain, Keystore), dan bukan di
localStorage. - API untuk klien pihak ketiga. Mereka diberikan kunci terpisah atau token OAuth dengan hak terbatas.
- Panggilan antar-layanan. JWT yang berumur pendek antar layanan Anda justru nyaman karena diverifikasi tanpa basis yang sama.
Kesalahan yang sering terjadi
- Refresh token di
localStorageketika token akses berumur pendek. Token penyegaran yang dicuri memberikan akses jangka panjang - semua manfaat jangka pendek hilang. Domain=.example.comuntuk cookie sesi yang tidak diperlukan. Subdomain apa pun, termasuk laman landas yang rentan, akan menerimanya. Awalan__Host-menonaktifkan atributDomaindan menutup opsi ini.- Memeriksa
expuntuk JWT tanpa verifikasi tanda tangan atau dengan algoritma dari header token. Rekam algoritma di server.
Ringkasan
Untuk aplikasi web dengan backendnya sendiri: pengidentifikasi buram di cookie httpOnly, catatan sesi di database, SameSite=Lax dan centang Origin. JWT dan header Authorization - untuk klien non-browser dan untuk komunikasi antar layanan.