جلسة في ملف تعريف الارتباط httpOnly أو JWT في localStorage: ماذا تختار لتطبيق ويب
السؤال مطروح بشكل غير دقيق
يخلط الجدل حول ملفات تعريف الارتباط مقابل JWT بين حلين مستقلين:
- 1.حيث يقوم العميل بتخزين الرمز المميز: ملف تعريف الارتباط httpOnly، الذي يرسله المتصفح بنفسه، أو
localStorage، حيث يقرأه JavaScript ويضعه في رأسAuthorization. - 2.ما هو هذا الرمز المميز: معرف جلسة غير شفاف يستطيع الخادم من خلاله العثور على إدخال في قاعدة البيانات، أو JWT موقّع ذاتي الاكتفاء.
يمكن تخزين JWT في ملف تعريف الارتباط httpOnly ومعرف الجلسة في localStorage. ولذلك، سوف نقوم بتحليل كل حل على حدة.
مكان التخزين: عواقب XSS
إذا تم تنفيذ البرنامج النصي الخاص بشخص آخر على الصفحة (التبعية الضعيفة، أو إدخال المستخدم الذي لم يتم تجاوزه، أو البرنامج النصي للتحليلات المخترقة):
- الرمز المميز في `localStorage` سيتم قراءة البرنامج النصي وإرساله إلى الخادم الخاص به. يستخدم المهاجم الجلسة من جهازه عندما يكون الرمز صالحًا، حتى بعد قيام الضحية بإغلاق علامة التبويب.
- لا يمكن قراءة الرمز المميز الموجود في ملف تعريف الارتباط httpOnly بواسطة البرنامج النصي. يمكنه إرسال طلبات نيابة عن المستخدم أثناء فتح الصفحة - يظل XSS يمثل ثغرة أمنية خطيرة. ولكن لا يمكنك سرقة جلسة وتأخذها معك.
الفرق ليس ما إذا كان ملف تعريف الارتباط "يحمي ضد XSS" (لا يفعل ذلك)، ولكن في مدى الضرر. بالنسبة لتطبيق ويب حيث تكون الواجهة الأمامية وواجهة برمجة التطبيقات (API) على نفس الموقع، فإن هذا يحل المشكلة لصالح ملفات تعريف الارتباط.
سعر ملف تعريف الارتباط: CSRF
يرسل المتصفح ملفات تعريف الارتباط تلقائيًا، بما في ذلك الطلبات التي يبدأها موقع آخر. الحماية في عدة طبقات:
SameSite=Lax(الإعداد الافتراضي في متصفحات Chromium، ولكن تم تعيينه بشكل صريح) لا يرسل ملفات تعريف الارتباط مع طلبات POST عبر المواقع.- لتعديل الطلبات، يقوم الخادم بفحص رأس
Originويرفض الطلبات الواردة من أصل أجنبي. - تغييرات الحالة - فقط باستخدام أساليب POST/PUT/PATCH/DELETE، ولا يتم الحصول عليها مطلقًا.
تقوم إجراءات الخادم في Next.js بفحص Origin بنفسها؛ بالنسبة لمعالجات الطريق الخاصة بك، يمكنك كتابة الشيك.
ما يجب تخزينه: استدعاء الجلسة
يتحقق الخادم من JWT الموقع دون الوصول إلى قاعدة البيانات. الجانب السلبي: لا يمكن إبطاله قبل تاريخ انتهاء الصلاحية. قام المستخدم بالنقر فوق "تسجيل الخروج من جميع الأجهزة"، وقام المسؤول بحظر الحساب، وتم اكتشاف الرمز المميز المسروق - يستمر JWT في العمل. تعمل الحلول البديلة (العمر القصير بالإضافة إلى رمز التحديث، القائمة الملغاة) على إرجاع الوصول إلى وحدة التخزين، والتي تم اختيار 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 });
}التفاصيل الرئيسية:
- تحتوي قاعدة البيانات على تجزئة، وليس رمزًا مميزًا. لا يوفر تسرب التفريغ أو الوصول للقراءة فقط إلى الجدول جلسات عمل جاهزة.
- 32 بايت عشوائي من مولد التشفير - القوة الغاشمة غير ممكنة، ولا يلزم التوقيع.
- جلسة جديدة عند تسجيل الدخول، بدلاً من زيادة الحقوق القديمة. وبخلاف ذلك، يكون تثبيت الجلسة ممكنًا: حيث يرسل المهاجم معرفه إلى الضحية قبل تسجيل الدخول.
- `cookies()` غير متزامن في Next.js 15، وبالتالي
await. يمكنك تعيين ملفات تعريف الارتباط في إجراءات الخادم ومعالجات التوجيه، ولكن ليس عند عرض مكون الخادم.
"تسجيل الخروج على جميع الأجهزة" - DELETE FROM sessions WHERE user_id = $1. قائمة الجلسات النشطة مع user_agent والتاريخ هي مكافأة مجانية لهذا المخطط.
عندما يكون الرمز المميز في الرأس مبررًا
- تطبيق الهاتف المحمول أو واجهة سطر الأوامر (CLI). ملفات تعريف الارتباط غير ملائمة هناك، حيث يتم تخزين الرمز المميز في وحدة التخزين الآمنة للنظام الأساسي (Keychain، Keystore)، وليس في
localStorage. - واجهة برمجة التطبيقات (API) لعملاء الجهات الخارجية. يتم إصدار مفاتيح منفصلة أو رموز OAuth مميزة لها حقوق محدودة.
- المكالمات بين الخدمات. تعتبر JWT قصيرة العمر بين خدماتك ملائمة على وجه التحديد لأنه تم التحقق منها بدون قاعدة مشتركة.
أخطاء متكررة
- تحديث الرمز المميز في
localStorageعندما يكون رمز الوصول قصير الأجل. يمنح رمز التحديث المسروق إمكانية الوصول على المدى الطويل - حيث يتم فقدان جميع الفوائد قصيرة المدى. Domain=.example.comلملفات تعريف الارتباط للجلسة دون داع. أي نطاق فرعي، بما في ذلك الصفحة المقصودة الضعيفة، سوف يستقبله. تعمل البادئة__Host-على تعطيل السمةDomainوإغلاق هذا الخيار.- التحقق من
expلـ JWT بدون التحقق من التوقيع أو باستخدام الخوارزمية من رأس الرمز المميز. سجل الخوارزمية على الخادم.
ملخص
بالنسبة لتطبيق ويب ذو واجهة خلفية خاصة به: معرف غير شفاف في ملف تعريف الارتباط httpOnly، وسجلات الجلسة في قاعدة البيانات، SameSite=Lax وتحقق من Origin. JWT والرأس Authorization - للعملاء الذين لا يستخدمون المتصفح وللاتصال بين الخدمات.