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

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

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

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

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

   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 */);
   

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

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

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

   

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

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

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

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

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

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

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

   

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

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

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

   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 قبولها. الرمز المميز الذي يرسله على أنه صالح.