CHIPS لحالة المكوّن المضمّن، لا للهوية بين المواقع
ينشئ CHIPS مخزن ملفات تعريف ارتباط منفصلًا لكل موقع علوي يضمّن المكوّن. تعرّف إلى الحالات المناسبة له ولماذا لا يوفر هوية مشتركة بين مواقع الأطراف الثالثة.
يمكن لملف تعريف ارتباط مُقسّم أن يُبقي أداة مضمّنة مسجّلة الدخول على موقع واحد، لكنه لا يمنحها هوية مشتركة عبر جميع المواقع التي تضمّنها. يؤثر هذا الفرق في طريقة تصميم المطورين لمكوّنات الدردشة والدفع والمستندات ومزوّدي الحسابات المضمّنة.
ينشئ CHIPS جلسة مستقلة لكل موقع مُضمِّن
يتيح CHIPS (Cookies Having Independent Partitioned State) للمكوّن المضمّن عبر المواقع اختيار التخزين المقسّم باستخدام السمة Partitioned. يربط المتصفح ملف تعريف الارتباط بالموقع الذي أنشأه وبالموقع العلوي. عندما يُضمَّن المزوّد نفسه في موقعين غير مرتبطين، يحصل على مخزنين منفصلين لملفات تعريف الارتباط، لا مخزن واحد مشتركًا على مستوى المزوّد.
على سبيل المثال، يمكن لـ support.example المضمّن في shop.example إنشاء ملف جلسة يخص سياق التضمين هذا:
Set-Cookie: __Host-widget_session=opaque-value; Secure; Path=/; SameSite=None; Partitioned
تعتمد هذه الضمانات على دعم المتصفح. قد يتجاهل المتصفح السمة Partitioned إذا لم يدعمها، فيبقى ملف ارتباط تابع لجهة خارجية دون تقسيم إذا سمح به المتصفح. اختبر كل متصفح مستهدف ولا تفترض أن السمة وحدها تفرض العزل.
يرسل المتصفح هذا الملف عندما تُحمَّل الأداة ضمن shop.example، لكنه لا يرسله عند تحميل الأداة نفسها ضمن docs.example. كما لا يصبح ملف تعريف الارتباط المقسّم عامًا عندما يزور المستخدم support.example مباشرة. لكل موقع علوي سياق مستقل؛ لذلك يبدأ أول استخدام من خلال موقع مُضمِّن آخر من دون جلسة الأداة الخاصة بالموقع السابق.
يفيد ذلك عندما يحتاج المكوّن المضمّن إلى حالة محلية لموقع ناشر واحد: مثل محادثة دعم مرتبطة بذلك الموقع، أو تفضيل خاص به، أو سلة تسوّق تخص متجرًا واحدًا. يستطيع المكوّن حفظ الحالة من دون اعتبار ظهوره في مواقع غير مرتبطة معرّفًا مشتركًا.
اختر ملف تعريف الارتباط وفق الحالة المطلوبة
اختر CHIPS عندما تظل الميزة تعمل حتى لو كان لكل موقع مُضمِّن جلسة مستقلة. ينبغي أن يكون الخادم مستعدًا لغياب ملف تعريف الارتباط في موقع علوي جديد، وأن ينشئ جلسة جديدة خاصة بالمكوّن بدلًا من استنتاج أن المستخدم سجّل الخروج من كل المواقع أو دمج الجلسة بصمت مع حالة موقع آخر.
لا تستخدم ملف تعريف ارتباط مقسّمًا بوصفه ملف الحساب لخدمة تتوقع التعرّف على الشخص عبر مواقع أطراف ثالثة غير مرتبطة. يفرض المتصفح السلوك المعاكس: يحصل النطاق الخارجي نفسه على حالات مقسّمة مختلفة في سياقات علوية مختلفة. على الأداة التي تحتاج إلى حساب مشترك الحصول على الهوية عبر مسار منفصل وصريح.
هذا فصل معماري، وليس خللًا ينبغي التحايل عليه بتغيير أسماء ملفات تعريف الارتباط أو تدوير قيمها. إذا كانت الوظيفة الأساسية للمكوّن تعتمد على إتاحة الهوية نفسها في كل مكان، فلن يفي CHIPS وحده بهذا المتطلب. أما إذا كان المطلوب استمرار الحالة المحلية للمكوّن فقط، فالتقسيم أنسب من الاعتماد على ملف تعريف ارتباط لطرف ثالث مشترك بين المواقع.
Storage Access عقد مختلف
عندما يحتاج المكوّن فعلًا إلى حالته غير المقسّمة المتاحة في سياق الطرف الأول — مثل عرض حساب سبق للمستخدم تسجيل الدخول إليه على موقع المزوّد نفسه — توفّر Storage Access API (SAA) مسار طلب منفصلًا. يمكن للمستند المضمّن التحقق من document.hasStorageAccess() واستدعاء document.requestStorageAccess() عند الحاجة. يتعلق المنح بالوصول من سياق التضمين هذا؛ ولا يحوّل ملفات CHIPS إلى مخزن مشترك.
تعامل مع الطلب بوصفه فرعًا مشروطًا في تدفق المنتج. قد تشترط المتصفحات تفاعلًا من المستخدم، أو زيارة سابقة للموقع بوصفه صفحة علوية، أو شروط أهلية أخرى، وقد يُرفض الطلب. فمثلًا، توصي إرشادات WebKit بربط الطلب بإجراء من المستخدم وتشترط تفاعلًا سابقًا بصفة الطرف الأول. تختلف سياسات المتصفحات؛ لذلك لا يثبت نجاح الطلب في محرك واحد أن كل مستخدمي المكوّن سيحصلون على الوصول.
loginButton.addEventListener("click", async () => {
try {
await document.requestStorageAccess();
await loadAccount();
} catch {
showSignedOutExperience();
}
});
المسار البديل جزء من الميزة، وليس شاشة خطأ استثنائية. اسمح للمستخدم بمتابعة الميزات العامة أو ذات الحالة المحلية للمكوّن عند تعذر الوصول، واعرض إجراء تسجيل دخول واضحًا عند الحاجة إلى بيانات الحساب. وتذكّر أن الوصول إلى تخزين المستند المضمّن لا يرفق هذه الهوية تلقائيًا بالطلبات المرسلة إلى واجهة API على نطاق مختلف.
اختبر الحدود، لا المسار الناجح فقط
اختبر المكوّن نفسه ضمن موقعين علويين مختلفين، وتأكد من أن كلًا منهما يبدأ بحالة مستقلة. ثم اختبر المزوّد بوصفه موقعًا علويًا، وحالة رفض طلب SAA، وطلبات API العابرة للنطاقات التي يرسلها المكوّن. افحص مفتاح التقسيم في أدوات المطور بالمتصفح، وتحقق من ملفات تعريف الارتباط التي تصل فعلًا إلى كل نقطة نهاية.
تكشف هذه الحالات الافتراض الذي يتسبب غالبًا في تعطل التطبيقات المضمّنة: يمكن لمكوّن تابع لطرف ثالث الظهور في أماكن كثيرة من دون أن يمثّل المستخدم نفسه المسجّل الدخول في كل مكان. استخدم CHIPS للحالة التابعة لموقع مُضمِّن واحد، واستخدم تدفق هوية صريحًا يتطلب مشاركة المستخدم عندما يحتاج المنتج فعلًا إلى حساب مشترك.
Comments
Loading comments…