الاستعداد للإيقاف النهائي لملفات تعريف الارتباط التابعة لجهات خارجية

يساعدك هذا الدليل في فهم التأثير والتغييرات الضرورية التي يجب إجراؤها على إضافتك التي تم تقديمها بواسطة إيقاف Chrome نهائيًا دعم ملفات تعريف الارتباط التابعة لجهات خارجية.

نظرة عامة

في 4 يناير 2024، طرح Chrome ميزة الحماية من التتبّع التي تحظر تلقائيًا وصول المواقع الإلكترونية إلى ملفات تعريف الارتباط التابعة لجهات خارجية (3P) بالنسبة إلى% 1 من المستخدمين. ويتوقّع Chrome أن يتم الإيقاف النهائي لملفات تعريف الارتباط التابعة لجهات خارجية بالكامل في أوائل عام 2025.

تتأثر تجربتا مستخدم على الأقل في إضافات Classroom:

1. مسار الدخول المُوحَّد (SSO) من Google
2. فتح علامات تبويب جديدة للمستخدمين

الدخول المُوحَّد (SSO) من Google

أثناء مسار الدخول المُوحَّد (SSO) من Google، يتم توجيه المستخدمين إلى مربّع حوار لتسجيل الدخول إلى حساب Google والموافقة على مشاركة البيانات.

الشكل 1: تصوّر لسياقات ملفات تعريف الارتباط الثلاثة المختلفة أثناء الدخول المُوحَّد (SSO) من داخل إطار iframe: (1) تطبيق Classroom ذو المستوى الأعلى، و(2) إطار iframe الخارجي المضمّن (DavidPuzzle على المضيف المحلي في هذه الحالة)، و(3) مربّع حوار OAuth ذو المستوى الأعلى.

في عملية تنفيذ الإضافة النموذجية، يتم ضبط ملف تعريف ارتباط الجلسة عند إكمال عملية تسجيل الدخول هذه. ويتم إعادة تحميل إطار iframe الخاص بالإضافة، الذي يكون في سياق مضمّن، الآن باستخدام ملف تعريف ارتباط الجلسة، ما يسمح للمستخدم بالوصول إلى جلسته التي تم التحقّق من هويته فيها. ومع ذلك، عند إيقاف ملفات تعريف الارتباط التابعة لجهات خارجية، لا يمكن للمواقع الإلكترونية في سياق مضمّن، مثل إطارات iframe الخاصة بالإضافات، الوصول إلى ملفات تعريف الارتباط من سياقاتها ذات المستوى الأعلى المقابلة. بالنسبة إلى إضافات Classroom، لا يمكن للمستخدم الوصول إلى جلسته التي تم التحقّق من هويته فيها ويظلّ عالقًا في حلقة تسجيل الدخول.

بالنسبة إلى عمليات التنفيذ التي تضبط ملف تعريف ارتباط الجلسة في سياق إطار iframe المضمّن، يمكن التخفيف من هذه المشكلة باستخدام CHIPS API، الذي يسمح للمواقع الإلكترونية المضمّنة بـ ضبط ملفات تعريف الارتباط المقسّمة والوصول إليها (ملفات تعريف الارتباط التي يتم وضع مفتاح لها استنادًا إلى كل من النطاق المضمِّن و النطاق المضمَّن). ومع ذلك، لا يمكن لعمليات التنفيذ التي تضبط ملف تعريف ارتباط الجلسة في سياق المستوى الأعلى لمربّع حوار تسجيل الدخول الوصول إلى ملف تعريف الارتباط غير المقسّم في إطار iframe، ما يمنع تسجيل الدخول.

علامات تبويب جديدة

للأسباب نفسها، إذا كانت لدى المستخدم جلسة تم التحقّق من هويته فيها تستند إلى ملف تعريف ارتباط في إطار iframe الخاص بإضافة، وفتح إطار iframe علامة تبويب جديدة ذات مستوى أعلى للمستخدم من أجل نشاط، لا يمكن لعلامة التبويب ذات المستوى الأعلى الوصول إلى ملف تعريف ارتباط الجلسة المقسّم من إطار iframe. يمنع ذلك استمرار حالة الجلسة في إطار iframe إلى نشاط علامة التبويب الجديدة وقد يفرض على المستخدم تسجيل الدخول مرة أخرى في علامة التبويب الجديدة، على سبيل المثال. لا يمكن لـ CHIPS API حلّ هذه المشكلة، وذلك حسب التصميم، إذ لا يمكن الوصول إلى ملفات تعريف ارتباط إطار iframe المقسّمة في سياق ذي مستوى أعلى.

إجراءات المطوّرين

هناك بعض الإجراءات التي يجب أخذها في الاعتبار لضمان استمرار عمل إضافتك على النحو المطلوب أثناء الإيقاف النهائي لملفات تعريف الارتباط التابعة لجهات خارجية في Chrome.

1. راجِع استخدام ملفات تعريف الارتباط التابعة لجهات خارجية في تجارب المستخدم الأساسية في إضافتك. على وجه التحديد، اختبِر إضافتك مع إيقاف ملفات تعريف الارتباط التابعة لجهات خارجية لتقييم التأثير في عملية التنفيذ المحدّدة.

2. استكشِف واجهة برمجة التطبيقات Storage Access API. ننصحك باستكشاف واجهة برمجة التطبيقات Storage Access API (SAA) لجميع عمليات تنفيذ الإضافات. تسمح SAA لإطارات iframe بالوصول إلى ملفات تعريف الارتباط الخاصة بها خارج سياق إطار iframe. تتوفّر SAA في Chrome اليوم، وهي متوافقة مع تطبيق Classroom.

3. فعِّل FedCM. بالإضافة إلى ذلك، إذا كنت تستخدم GIS، تنصح الإرشادات الرسمية من فريق "الهوية" بتفعيل FedCM باستخدام مكتبة "تسجيل الدخول باستخدام حساب Google" . لا يحلّ ذلك محلّ إمكانات ملفات تعريف الارتباط التابعة لجهات خارجية، ولكن سيصبح مطلوبًا في النهاية في GIS كجزء من الإيقاف النهائي لملفات تعريف الارتباط التابعة لجهات خارجية. تتوفّر FedCM في Chrome اليوم ومتوافقة مع Classroom، ولكن لا تزال السلوكيات والميزات قيد التطوير ومتاحة لتلقّي الملاحظات.

4. انقل بياناتك إلى GIS. إذا كنت تستخدم مكتبة GSIv2 التي تم إيقافها، والمعروفة أيضًا باسم مكتبة تسجيل الدخول باستخدام حساب Google، يُنصح بشدة بأن تنقل بياناتك إلى GIS، لأنّه من غير الواضح ما إذا كان سيتم مواصلة دعم GSIv2 في المستقبل.

5. قدِّم طلبًا لتأخير إعادة ميزة تم إيقافها نهائيًا. يقدّم Chrome فترة تجربة خاصة بإعادة ميزة تم إيقافها نهائيًا للسماح بحالات الاستخدام غير الإعلانية بتأخير آثار الإيقاف النهائي لملفات تعريف الارتباط التابعة لجهات خارجية. في حال قبول طلبك، سيتم منحك رمزًا مميزًا يمكنك استخدامه في إضافتك لإبقاء ملفات تعريف الارتباط التابعة لجهات خارجية مفعّلة لمصدرك حتى عام 2024، أثناء نقل بياناتك إلى حلّ طويل الأمد مثل SAA. بعد تقديم الطلب، سيُطلب منك تقديم رقم تعريف خطأ أو رابط لتقرير عن حدوث عطل. لقد قدّم فريقنا هذا الخطأ بالفعل لإضافات Classroom ويمكنك تقديم هذا الخطأ.