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

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

نظرة عامة

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

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

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

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

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

تصوير سياقات ملفات تعريف الارتباط الثلاثة المختلفة أثناء عملية الدخول المُوحَّد من داخل إطار iframe

الشكل 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‏ (SAA): ننصحك باستكشاف واجهة برمجة التطبيقات Storage Access API‏ (SAA) لجميع عمليات تنفيذ الإضافات. تتيح واجهة برمجة التطبيقات SAA لإطارات iframe الوصول إلى ملفات تعريف الارتباط الخاصة بها خارج سياق إطار iframe. تتوفّر واجهة برمجة التطبيقات SAA في Chrome اليوم، وهي متوافقة مع تطبيق Classroom.

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

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

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