سرفصل‌ها درس 35 از 156 · HTTP از درون
HTTP از درون

Cookie و Set-Cookie را تجزیه کنید

چرا مهم است کوکی‌ها شناسهٔ ردیابی‌ای هستند که واقعاً می‌توانید ببینید. خواندن درست یک خط Set-Cookie به شما می‌گوید یک سایت چه مدت می‌خواهد شما را به خاطر بسپارد، آیا اسکریپت‌ها می‌توانند کوکی را بخوانند، و آیا می‌تواند شما را در سایت‌های دیگر دنبال کند. درست‌کردن قواعد کوچک همچنین چیزی است که ورودها را ایمن نگه می‌دارد.

برگردیم به رخت‌کن. Set-Cookie متصدی‌ای است که ژتونی به شما می‌دهد، با ریزنویسی پشت آن: «معتبر برای یک سال»، «فقط دم پیشخوان اصلی نشان دهید»، «به جاهای دیگر نشانش ندهید». Cookie این است که همهٔ ژتون‌هایتان برای آن پیشخوان را یک‌جا پس می‌دهید، بدون ریزنویس.

Set-Cookie: سرآیند پاسخی که از مرورگر می‌خواهد یک کوکی را ذخیره کند. یک سرآیند برای هر کوکی: Set-Cookie: sid=7f3a; Path=/; Secure; HttpOnly; SameSite=Lax.

سرآیند Cookie: سرآیند درخواستی که هر کوکی‌ای را که مرورگر برای فرستادن انتخاب کرد حمل می‌کند، به شکل جفت‌های name=value که با ; به هم چسبیده‌اند، برای مثال Cookie: sid=7f3a; theme=dark. فقط نام‌ها و مقدارها سفر می‌کنند، هرگز ویژگی‌ها.

ویژگی (attribute): تکه‌ای از ریزنویس پس از اولین ; در Set-Cookie. برخی مقدار دارند (Max-Age=3600)، برخی پرچم‌هایی‌اند که فقط حضور دارند (Secure).

ویژگی‌هایی که تجزیه خواهید کرد

  • Expires=Thu, 01 Oct 2026 00:00:00 GMT: کوکی را در این تاریخ فراموش کن. فعلاً متن را نگه دارید؛ ظرف کوکی آن را به یک زمان تبدیل می‌کند.
  • Max-Age=3600: پس از این تعداد ثانیه فراموشش کن. صفر یا منفی یعنی همین حالا حذف کن. اگر هر دو باشند، Max-Age برنده است.
  • Domain=shopa.example: به زیردامنه‌ها هم بفرست. یک نقطهٔ آغازین (.shopa.example) نادیده گرفته می‌شود، و نام‌ها با حروف کوچک مقایسه می‌شوند.
  • Path=/account: فقط برای نشانی‌های زیر این مسیر بفرست. مقداری که با / شروع نشود نادیده گرفته می‌شود.
  • Secure: فقط روی HTTPS. HttpOnly: اسکریپت‌های صفحه نمی‌توانند آن را بخوانند.
  • SameSite=Strict، Lax یا None: آیا با درخواست‌هایی از سایت‌های دیگر همراه می‌رود. هر مقدار دیگری مثل داده‌نشده حساب می‌شود.
  • Partitioned: برای هر سایت سطح بالا یک نسخهٔ جداگانه نگه دار (CHIPS، از مرحلهٔ 1).

بخش‌های ظریف

مرورگرها عمداً آسان‌گیرند، و تجزیه‌گر شما هم باید باشد. نام ویژگی‌ها بزرگی و کوچکی حروف را نادیده می‌گیرند، پس secure و SECURE هر دو حساب می‌شوند. فاصله‌ها دور = و ; مجازند. ویژگی‌ای که مرورگر نمی‌شناسد (Priority=High، یا یک غلط تایپی) نادیده گرفته می‌شود، نه خطا. مقدارها می‌توانند = داشته باشند، مانند token=a=b، پس فقط در اولین = جدا کنید.

برخی خط‌ها کاملاً نادیده گرفته می‌شوند: بخش اولی که اصلاً = ندارد، یا نامش خالی است. قواعد کنونی کوکی، draft-ietf-httpbis-rfc6265bis (به‌عنوان استاندارد تأیید شده و در انتظار شمارهٔ RFC، بررسی‌شده در اکتبر 2026)، چند کوکی بی‌نام غیرعادی را مجاز می‌دانند؛ مرورگر تمرینی ما آن را ساده نگه می‌دارد و نادیده‌شان می‌گیرد، و شما هم همین کار را می‌کنید.

parse_set_cookie("id=7f3a; Max-Age=600; domain=.ShopA.example; Path=/; secure; SameSite=lax")
# {"name": "id", "value": "7f3a", "expires": None, "max_age": 600,
#  "domain": "shopa.example", "path": "/", "secure": True, "httponly": False,
#  "samesite": "Lax", "partitioned": False}

یک تصور نادرست رایج

«سرآیند Cookie به سرور می‌گوید کوکی‌ام کی منقضی می‌شود.» نمی‌گوید. مرورگر همهٔ ریزنویس را برای خودش نگه می‌دارد و فقط name=value را می‌فرستد. سروری که می‌خواهد بداند یک کوکی چه مدت دوام می‌آورد باید به خاطر بسپارد چه چیزی تنظیم کرد.

امتحان کنید در DevTools، Application (Chrome، Edge) یا Storage (Firefox) را باز کنید، سپس Cookies، و یک سایت را انتخاب کنید. هر ردیف یک Set-Cookie تجزیه‌شده است: ستون‌های Expires، Domain، Path، Secure، HttpOnly، SameSite و Partitioned را با فیلدهایی که تجزیه‌گرتان برمی‌گرداند مقایسه کنید.

در زبان‌های دیگر

JavaScript:

function parseSetCookie(line) {
  const [first, ...attrs] = line.split(";");
  const i = first.indexOf("=");
  if (i < 0 || !first.slice(0, i).trim()) return null;
  const c = { name: first.slice(0, i).trim(), value: first.slice(i + 1).trim() };
  for (const a of attrs) {
    const j = a.indexOf("=");
    const key = (j < 0 ? a : a.slice(0, j)).trim().toLowerCase();
    const val = j < 0 ? "" : a.slice(j + 1).trim();
    if (key === "secure") c.secure = true;
    else if (key === "max-age" && /^-?\d+$/.test(val)) c.maxAge = Number(val);
    // ... and the rest, as in Python
  }
  return c;
}

Go:

// Go parses both for you: http.ParseSetCookie (Go 1.23+) and http.ParseCookie
c, err := http.ParseSetCookie("id=7f3a; Max-Age=600; Secure; SameSite=Lax")
if err == nil {
    fmt.Println(c.Name, c.Value, c.MaxAge, c.Secure, c.SameSite)
}

PHP:

// a server sets a cookie with every attribute named:
setcookie('sid', $id, ['expires' => time() + 3600, 'path' => '/',
    'secure' => true, 'httponly' => true, 'samesite' => 'Lax']);

خلاصه

  • Set-Cookie یک کوکی به‌علاوهٔ ویژگی‌هایش را حمل می‌کند؛ سرآیند Cookie فقط جفت‌های name=value را حمل می‌کند.
  • در اولین = جدا کنید، نام ویژگی‌ها را با حروف کوچک مقایسه کنید، و از آنچه نمی‌شناسید بگذرید.
  • Max-Age باید یک عدد صحیح باشد، Path باید با / شروع شود، و یک نقطهٔ آغازین در Domain نادیده گرفته می‌شود.
  • خطی بدون = یا بدون نام کاملاً نادیده گرفته می‌شود.
نوبت شما

parse_cookie_header(text) را بنویسید: مقدار Cookie درخواست به شکل یک dict (روی ; جدا کنید، سپس در اولین =، هر دو را strip کنید، از تکه‌های بدون = یا بدون نام بگذرید، اولین مقدار یک نام برنده است). parse_set_cookie(line) را بنویسید: یک dict با کلیدهای name، value، expires (متن خام یا None)، max_age (یک int وقتی مقدار رقم‌های ASCII ساده با حداکثر یک - آغازین است، همان‌طور که مرورگرها لازم می‌دانند؛ هر چیز دیگری، مانند +5، 1_000 یا --5، نادیده گرفته می‌شود و None می‌دهد)، domain (حروف کوچک، نقطهٔ آغازین حذف‌شده، یا None)، path (فقط اگر با / شروع شود)، secure، httponly، partitioned (بولی) و samesite ("Strict"، "Lax"، "None" یا None)، یا None برای خطی بدون = یا با نام خالی.

مشکلی در این درس دیدید؟ گزارشش کنید · دربارهٔ این درس بپرسید

این تمرین به‌زودی باز می‌شود

درس پیش از آن را تمام کنید تا این یکی باز شود. کل دوره رایگان است، حساب کاربری لازم نیست، و می‌توانید همین الان این درس را بخوانید.