المنهج الدراسي الدرس 121 من 156 · بناء الدفاعات
بناء الدفاعات

قواعد الوصول إلى التخزين

لماذا هذا مهم عملية Partitioning توقف أدوات التتبع، لكنها تخرجك أيضاً من الأشياء المدمجة التي تريدها فعلاً: صندوق تعليقات، فيديو تدفع ثمنه، أو زر تسجيل دخول. إذا لم يوفر المحرك أي طريقة للعودة، سيقوم الأشخاص بإيقاف الحماية. واجهة Storage Access API هي تلك الطريقة للعودة، وقواعدها تقرر ما إذا كانت تساعدك أو تساعد أداة تتبع. في هذا المختبر ستكتب تلك القواعد.

فكر في بطاقة مكتبة. لقد سجلت في المكتبة، لذا تعمل البطاقة هناك. أنت الآن في منزل صديق، وقاعدة منزلهم هي أن البطاقات الخارجية لا تعمل في الداخل. لا يزال بإمكانك استخدام بطاقتك هناك إذا you سلمتها عن قصد، فالمكتبة هي التي انضممت إليها حقا، والإذن هو لهذا المنزل فقط، لفترة من الوقت.

في عالم التطبيق العملي، talk.example هي خدمة تعليقات. يقوم Sam بتسجيل الدخول على talk.example نفسه. يتم تضمين widget الخاص بها على news.example. عند تفعيل partitioning، يحصل widget الموجود على موقع الأخبار على cookie jar جديد وفارغ، لذا يظهر "sign in to post" على الرغم من أن Sam قام بتسجيل الدخول.

إطار مضمن (iframe): صفحة تظهر داخل صفحة أخرى، مثل نافذة في جدار. أداة التعليقات هي إطار من talk.example داخل news.example.

إيماءة المستخدم: نقرة حقيقية أو لمس أو ضغطة مفتاح من قبل الشخص، قبل لحظة. تسمي المتصفحات ذلك تنشيط المستخدم. لا يمكن لسكربت يعمل من تلقاء نفسه تزييفها.

Grant: ملاحظة المتصفح بأن موقعا مضمنا قد يستخدم ملفات تعريف ارتباط خاصة به داخل موقع رئيسي واحد، حتى وقت انتهاء الصلاحية.

كيف يبدو الـ API الحقيقي

داخل الإطار، يمكن للسكربت أن يسأل document.hasStorageAccess() (هل لدي ملفات تعريف الارتباط الخاصة بي؟) وبعد نقرة، document.requestStorageAccess() (يرجى إعطاؤها لي). يتحقق المتصفح من قواعده، وقد يظهر للمستخدم مطالبة، ثم يجيب بنعم أو لا. تتوفر الـ API في Safari و Firefox و Chrome (Chrome منذ الإصدار 119). في Chrome، الأمر يهم فقط للأشخاص الذين يحظرون ملفات تعريف الارتباط للطرف الثالث، لأن Chrome لا يزال يرسلها بشكل افتراضي، وميزة Related Website Sets التي كانت تمنح الوصول تلقائيا بعد الموافقة مرة واحدة قد تم إيقافها (تم التحقق في أكتوبر 2026). الدرس "The Storage Access API" في الوحدة السابقة غطى كيف تختلف المحركات؛ هنا تقوم ببناء القواعد الأساسية.

قواعد محركنا

تختلف المحركات الحقيقية في التفاصيل (prompts، time limits، extra checks). يستخدم محركنا التدريبي أربع قواعد بسيطة، يتم التحقق منها بالترتيب، والتي تلخص الأفكار المشتركة بينها:

  1. إذا كان موقع الإطار هو الموقع الأعلى، قل نعم: لديه بالفعل تخزينه الخاص.
  2. إذا لم تكن هناك إيماءة من المستخدم، قل لا. لا يمكن للـ widget أن يطلب بصمت أثناء تحميل الصفحة.
  3. إذا لم يسبق للشخص فتح موقع الإطار مباشرة (كصفحة رئيسية)، قل لا. هذا يمنع إطار إعلان لم تختره من الحصول على الوصول لمجرد أنك نقرت عليه.
  4. وإلا قل نعم، وسجل منحة لهذا الزوج بالضبط، (frame_site, top_site)، تنتهي صلاحيتها بعد GRANT_SECONDS (30 يوما) من الآن.

التحقق من الوصول لاحقا أبسط: الموقع نفسه يعني نعم؛ وإلا ابحث عن الزوج في grants وقل نعم فقط إذا كان موجودا ولم تنتهِ صلاحيته بعد.

أجزاء من Python ستستخدمها

grants = {}                                     # an empty dict
grants[("talk.example", "news.example")] = 5000 # key is a tuple, value an expiry time
expiry = grants.get(("talk.example", "blog.example"))
print(expiry)                                   # None: .get gives None when the key is missing
print(expiry is not None and 4000 < 5000)       # False, because expiry is None
يسأل

x is not None "هل توجد قيمة على الإطلاق؟". وضعها أولاً في and أمر مهم: إذا كانت False، فإن Python تتوقف ولا تقارن None مع رقم، وهو ما سيؤدي إلى خطأ.

الوقت في عالم الممارسة هو عد لثواني (world.now)، لذا فإن "30 يوما من الآن" هي مجرد now + 30 * 24 * 3600، والتي يعطيك إياها module كـ GRANT_SECONDS.

القصة التي يجب أن تجتاز قواعدك

يقوم

widget_story(request_fn, access_fn) بتشغيل ست خطوات على AccessBrowser ويمرر قائمة من أزواج (step, result):

خطوة نفسه
هل يجب تسجيل الدخول إلى widget؟
1. يفتح Sam ملف news.example (تم تسجيل الدخول في talk.example سابقاً)No: partitioned
2. يطلب الwidget عند تحميل الصفحة، بدون clickNo: لا توجد إيماءة
3. ينقر Sam على "Sign in to comment"نعم: مسموح لهذا الزوج
4. يفتح Sam ملف recipes.example باستخدام widgetNo: كانت المنحة لـ news.example فقط
5. يطلب إطار إعلان AdCo بعد النقر على advertNo: لم يفتح Sam أبداً adco.example
6. بعد 31 يوما، news.example مرة أخرىNo: انتهت صلاحية المنحة

تحتفظ الوحدة أيضاً بـ EXPECTED_STORY، وهي قائمة الإجابات الصحيحة، حتى تتمكن من المقارنة أثناء التقدم.

A مفهوم خاطئ شائع

"بمجرد حصول widget على صلاحية الوصول، يمكنه تتبعي في كل مكان." ليس مع هذه القواعد. الصلاحية مخصصة لزوج واحد من المواقع. الـ widget نفسه على موقع آخر يبدأ بـ jar فارغ مرة أخرى، وتنتهي الصلاحية. قاعدة الزوج هذه هي ما يمنع الـ API من أن يصبح وسيلة جديدة للتتبع.

في لغات أخرى

جانب الwidget، في JavaScript سيقوم widget التعليقات الحقيقي بالعمل:

// Inside the talk.example frame, on news.example
signInButton.addEventListener("click", async () => {      // a real click: a user gesture
  if (!(await document.hasStorageAccess())) {
    try {
      await document.requestStorageAccess();                // the browser applies its rules
    } catch {
      showMessage("Open talk.example to sign in first");   // refused
      return;
    }
  }
  loadComments();   // requests now carry talk.example's own cookie
});

جانب المحرك، فحص الوصول، في Rust:

use std::collections::HashMap;
fn has_storage_access(grants: &HashMap<(String, String), u64>,
                      frame_site: &str, top_site: &str, now: u64) -> bool {
    if frame_site == top_site { return true; }
    match grants.get(&(frame_site.to_string(), top_site.to_string())) {
        Some(expiry) => now < *expiry,
        None => false,
    }
}

ملخص

    يوفر
  • Partitioning إطارات مدمجة بوعاء فارغ؛ وتسمح Storage Access API للودجت المطلوب بطلب ملفات تعريف الارتباط الخاصة به.
  • تحتاج القواعد الجيدة إلى نقرة حقيقية، وموقع استخدمه الشخص فعليا، ومنحة لزوج واحد من المواقع تنتهي صلاحيته.
  • قاعدة الزوج هي ما يمنع الـ API من التحول إلى أداة تتبع.
  • يتوفر الـ API في متصفحات Safari وFirefox وChrome (Chrome 119)، تم التحقق في أكتوبر 2026.
دورك

اكتب request_storage_access(grants, frame_site, top_site, user_gesture, visited_before, now) باستخدام القواعد الأربعة بالترتيب: الموقع نفسه يعيد True؛ عدم وجود user_gesture يعيد False؛ ليس visited_before يعيد False؛ وإلا قم بتعيين grants[(frame_site, top_site)] = now + GRANT_SECONDS وأعد True. اكتب has_storage_access(grants, frame_site, top_site, now): True للموقع نفسه، وإلا True فقط عندما يكون الزوج في grants و now قبل انتهاء صلاحيته. ثم قم بتعيين story = widget_story(request_storage_access, has_storage_access).

هل لاحظت مشكلة في هذا الدرس؟ أبلغ عنها · اسأل عن هذا الدرس

سيفتح هذا التمرين قريبا

أنهِ الدرس السابق ليفتح هذا الدرس. الدورة كاملة مجانية، ولا تحتاج إلى حساب، ويمكنك قراءة هذا الدرس الآن.