خصائص ملفات تعريف الارتباط
جزء من قسم المصادقة والأمان في رحلة Node.js على Coddy. الدرس 8 من 17.
تنتقل ملفات تعريف الارتباط التي لا تحمل أي أعلام عبر HTTP غير المشفّر، وتُرفق بالطلبات التي تطلقها مواقع أخرى، وتظل موجودة حتى يُغلق المتصفح. تشدد أربعة خيارات في res.cookie إعداداتها:
httpOnly: لا تستطيع النصوص البرمجية في الصفحة قراءتها.sameSite: تمنع'lax'إرفاقها بالطلبات التي ترسلها مواقع أخرى، باستثناء الحالات التي يتبع فيها المستخدم رابطًا؛ أما'strict'فيمنع إرفاقها حتى بهذه الطلبات.secure: تُرسل عبر HTTPS فقط، ولا تُرسل أبدًا عبر HTTP غير المشفّر، حيث يستطيع الآخرون على الشبكة قراءتها.maxAge: مدة بقائها، بالمللي ثانية.
res.cookie('cart', cartId, {
httpOnly: true,
sameSite: 'strict',
secure: true,
maxAge: 30 * 60 * 1000, // 30 دقيقة
});التحدي
سهلملف تعريف الارتباط sid الناتج عن POST /login هو httpOnly وsameSite: 'lax' وsecure، وتدوم صلاحيته يومًا واحدًا: Max-Age=86400.
سجّل الدخول واقرأ Set-Cookie ضمن الرؤوس، ثم أرسل GET /me.
جرّب بنفسك
import express from 'express';
import { randomBytes } from 'node:crypto';
import { parseCookies } from './cookies.js';
import { notes, sessions, users } from './db.js';
import { hashPassword, verifyPassword } from './passwords.js';
const app = express();
app.use(express.json());
app.post('/signup', async (req, res) => {
const username = String(req.body.username ?? '').trim().toLowerCase();
const password = String(req.body.password ?? '');
if (!username || password.length < 8) {
return res.status(400).json({ error: 'Pick a username and a password of at least 8 characters' });
}
if (await users.findOne({ username })) {
return res.status(409).json({ error: 'That username is taken' });
}
await users.insertOne({ username, passwordHash: await hashPassword(password) });
res.status(201).json({ username });
});
app.post('/login', async (req, res) => {
const username = String(req.body.username ?? '').trim().toLowerCase();
const user = await users.findOne({ username });
if (!user || !(await verifyPassword(String(req.body.password ?? ''), user.passwordHash))) {
return res.status(401).json({ error: 'Wrong username or password' });
}
const sid = randomBytes(24).toString('base64url');
await sessions.insertOne({ _id: sid, userId: user._id, createdAt: new Date() });
res.cookie('sid', sid, { httpOnly: true });
res.json({ username: user.username });
});
// يعثر على المستخدم المرتبط بملف تعريف ارتباط الجلسة، أو يردّ بالرمز 401.
async function requireUser(req, res, next) {
const { sid } = parseCookies(req.get('cookie'));
const session = sid && (await sessions.findOne({ _id: sid }));
const user = session && (await users.findOne({ _id: session.userId }));
if (!user) {
return res.status(401).json({ error: 'Log in first' });
}
req.user = { id: user._id.toHexString(), username: user.username };
next();
}
app.get('/me', requireUser, (req, res) => {
res.json({ username: req.user.username });
});
app.post('/logout', async (req, res) => {
const { sid } = parseCookies(req.get('cookie'));
if (sid) {
await sessions.deleteOne({ _id: sid });
}
res.clearCookie('sid');
res.status(204).end();
});
// يحسب عدد المرات التي أرسل فيها هذا المتصفح طلب GET /visit.
app.get('/visit', (req, res) => {
const cookies = parseCookies(req.get('cookie'));
const visits = Number(cookies.visits ?? 0) + 1;
res.cookie('visits', String(visits));
res.json({ visits });
});
// الملاحظات: يقرأ كل مستخدم ملاحظاته ويكتبها فقط.
app.get('/notes', requireUser, async (req, res) => {
res.json(await notes.find({ owner: req.user.id }).toArray());
});
app.post('/notes', requireUser, async (req, res) => {
const note = { owner: req.user.id, text: String(req.body.text ?? '') };
await notes.insertOne(note);
res.status(201).json(note);
});
app.listen(3000, () => {
console.log('Vault is running on port 3000');
});
يتضمن هذا الدرس اختبارًا قصيرًا. ابدأ الدرس للإجابة عليه وتتبّع تقدمك.
جميع دروس المصادقة والأمان
2الجلسات وملفات تعريف الارتباط
التذكّر باستخدام ملفات تعريف الارتباطجلسات تسجيل الدخول