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

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

نظرة عامة

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

تتأثر إضافات 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 في علامة التبويب الجديدة. وقد تفرض على المستخدم تسجيل الدخول مرة أخرى في علامة التبويب الجديدة مثلاً. لم تتمكّن CHIPS API من حلّ هذه المشكلة بسبب التصميم. المقسَّم يتعذّر الوصول إلى ملفات تعريف ارتباط iframe في سياق المستوى الأعلى.

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

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

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

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

   ملاحظة: في حال لم يضبط مسار خدمة الدخول المُوحَّد (SSO) ملفات تعريف الارتباط في سياق مربّع الحوار المستخدمين إلى علامات التبويب ذات المستوى الأعلى، فقد لا تحتاج إلى إعلانات الربط (SAA). استكشِف CHIPS API الأبسط لمعرفة ما إذا كانت تلبّي احتياجاتك.

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

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

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

تحذير: سينفّذ المطوّرون الذين تم قبولهم في الفترة التجريبية للإيقاف النهائي الإجراءات التالية: تفعيل ملفات تعريف الارتباط التابعة لجهات خارجية تلقائيًا خلال فترة السماح حتى بدون رمز مميز في التطبيق. يُرجى الانتباه إلى هذا التنبيه إذا كنت تريد استخدام خيار الإيقاف النهائي بنسبة 1%. لاختبار طريقة عمل الإضافة بدون ملفات تعريف الارتباط التابعة لجهات خارجية.

ملاحظة: إنّ الفترة التجريبية للإيقاف النهائي مخصّصة للتطبيقات الحالية. إذا كنت تنشئ إضافة اليوم، وتخطط للبناء باستخدام SAA أو أي تنفيذ آخر يسمح بتشغيل الوظيفة الإضافية بدون ملفات تعريف الارتباط التابعة لجهات خارجية. قد لا تكون مؤهلاً للحصول على إذا لم يكن لديك تطبيق متأثّر بالإيقاف النهائي إذا لم يكن لديك تطبيق.

ملاحظة: أعلن Chrome عن تغيير في المخطط الزمني في الإيقاف التدريجي لملفات تعريف الارتباط التابعة لجهات خارجية من من النصف الثاني من 2024 إلى أوائل عام 2025. قد يؤثر هذا التغيير على مدة الفترة التجريبية للإيقاف النهائي، وسيتم تعديل هذه الصفحة لتعكس التغييرات.