استخدم التحقق من التطبيق مع موفر التصحيح في تطبيقات الويب

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

استخدم موفر التصحيح على المضيف المحلي

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

1. في بناء التصحيح الخاص بك ، قم بتمكين وضع التصحيح عن طريق تعيين self.FIREBASE_APPCHECK_DEBUG_TOKEN على true قبل تهيئة التحقق من التطبيق. على سبيل المثال:

   واجهة برمجة تطبيقات الويب المعيارية

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

   واجهة برمجة تطبيقات Web namespaced

   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. في قسم التحقق من التطبيق في وحدة تحكم 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 إلى قيمة متغير بيئة رمز التصحيح قبل استيراد App Check. على سبيل المثال:

   واجهة برمجة تطبيقات الويب المعيارية

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

   واجهة برمجة تطبيقات Web namespaced

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

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