استخدام ميزة "فحص التطبيقات" مع موفِّر تصحيح الأخطاء في تطبيقات الويب

إذا أردت، بعد تسجيل تطبيقك في ميزة "فحص التطبيقات"، تشغيل تطبيقك في بيئة لا تصنّفها عادةً ميزة "فحص التطبيقات" على أنّها صالحة، مثل بيئة التكامل المستمر (CI) أو بيئة التكامل المستمر (CI)، يمكنك إنشاء إصدار تصحيح أخطاء لتطبيقك يستخدم موفّر تصحيح أخطاء التطبيق بدلاً من موفّر تصديق حقيقي.

تحذير: يسمح موفِّر تصحيح الأخطاء بالوصول إلى موارد Firebase من أجهزة لم يتم التحقق منها. تجنَّب استخدام موفِّر خدمة تصحيح الأخطاء في الإصدارات الإنتاجية لتطبيقك ولا تشارك إصدارات تصحيح الأخطاء مع جهات غير موثوق بها.

استخدام موفِّر تصحيح الأخطاء على المضيف المحلي

لاستخدام موفِّر خدمة تصحيح الأخطاء أثناء تشغيل تطبيقك من localhost (أثناء التطوير مثلاً)، عليك اتّباع الخطوات التالية:

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

1. في إصدار تصحيح الأخطاء، فعِّل وضع تصحيح الأخطاء عن طريق ضبط self.FIREBASE_APPCHECK_DEBUG_TOKEN على true قبل إعداد فحص التطبيقات. على سبيل المثال:

   Web

   self.FIREBASE_APPCHECK_DEBUG_TOKEN = true;
   initializeAppCheck(app, { /* App Check options */ });
   

   Web

   self.FIREBASE_APPCHECK_DEBUG_TOKEN = true;
   firebase.appCheck().activate(/* site key or provider */);
   

   ملاحظة: في إصدارات Firebase Web SDK قبل الإصدار 9، تتم قراءة self.FIREBASE_APPCHECK_DEBUG_TOKEN في وقت الاستيراد، وليس في وقت التهيئة/التفعيل. وقد تطلب ذلك إعداده في index.html قبل تحميل حزمة الرموز. لتجنّب هذا القيد، يجب الترقية إلى الإصدار 9.

2. انتقِل إلى تطبيق الويب محليًا وافتح أداة مطوِّر المتصفّح. في وحدة تحكم تصحيح الأخطاء، سيظهر لك رمز مميز لتصحيح الأخطاء:

   AppCheck debug token: "123a4567-b89c-12d3-e456-789012345678". You will
   need to safelist it in the Firebase console for it to work.

3. في قسم فحص التطبيق ضمن وحدة تحكُّم Firebase، اختَر إدارة الرموز المميّزة لتصحيح الأخطاء من القائمة الكاملة لتطبيقك. ثم سجّل الرمز المميز لتصحيح الأخطاء الذي سجلته في الخطوة السابقة.

   

بعد تسجيل الرمز المميّز، ستقبله خدمات Firebase الخلفية على أنّه صالح.

وبما أنّ هذا الرمز المميّز يتيح لك الوصول إلى موارد Firebase بدون استخدام جهاز صالح، من الضروري الحفاظ على خصوصيته. لا تلتزم به في مستودع علني، وفي حال تعرُّض الرمز المميّز المسجَّل للاختراق في أي وقت، يمكنك إبطاله على الفور في "وحدة تحكُّم Firebase".

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

استخدام موفِّر تصحيح الأخطاء في بيئة CI

لاستخدام موفِّر خدمة تصحيح الأخطاء في بيئة تكامل مستمر (CI)، عليك إجراء ما يلي:

1. في قسم فحص التطبيق ضمن وحدة تحكُّم Firebase، اختَر إدارة الرموز المميّزة لتصحيح الأخطاء من القائمة الكاملة لتطبيقك. ثم أنشئ رمزًا مميزًا جديدًا لتصحيح الأخطاء. ستحتاج إلى الرمز المميز في الخطوة التالية.

   ولأن هذا الرمز يتيح إمكانية الوصول إلى موارد Firebase بدون جهاز صالح، فمن الأهمية بمكان أن تحافظ على خصوصيتها. لا تلتزم به في مستودع علني، وفي حال تعرُّض الرمز المميّز المسجَّل للاختراق في أي وقت، يمكنك إبطاله على الفور في "وحدة تحكُّم Firebase".

   

2. أضِف الرمز المميّز لتصحيح الأخطاء الذي أنشأته للتو إلى ملف تخزين المفاتيح الآمن في نظام CI (على سبيل المثال، الأسرار المشفرة في GitHub Actions أو المتغيّرات المشفَّرة من Travis CI).

3. إذا لزم الأمر، اضبط نظام CI لإتاحة الرمز المميّز لتصحيح الأخطاء داخل بيئة CI كمتغير للبيئة. أدخِل اسمًا للمتغير بشيء مثل APP_CHECK_DEBUG_TOKEN_FROM_CI.

4. في إصدار تصحيح الأخطاء، فعِّل وضع تصحيح الأخطاء من خلال ضبط self.FIREBASE_APPCHECK_DEBUG_TOKEN على قيمة متغيّر بيئة الرمز المميّز لتصحيح الأخطاء قبل استيراد فحص التطبيقات. على سبيل المثال:

   Web

   self.FIREBASE_APPCHECK_DEBUG_TOKEN = process.env.APP_CHECK_DEBUG_TOKEN_FROM_CI;
   initializeAppCheck(app, { /* App Check options */ });
   

   Web

   self.FIREBASE_APPCHECK_DEBUG_TOKEN = process.env.APP_CHECK_DEBUG_TOKEN_FROM_CI;
   firebase.appCheck().activate(/* site key or provider */);
   

عند تشغيل تطبيقك في بيئة CI، ستقبل خدمات Firebase الخلفية الرمز المميّز الذي ترسله على أنّه صالح.