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

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

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

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

1. في إصدار تصحيح الأخطاء، قبل استخدام أيّ من خدمات Firebase للواجهة الخلفية، أنشِئ واضبط المصنع الخاص بموفّر تصحيح الأخطاء في ميزة "التحقّق من التطبيقات":App Check

   Swift

   let providerFactory = AppCheckDebugProviderFactory()
   AppCheck.setAppCheckProviderFactory(providerFactory)
   
   FirebaseApp.configure()

   Objective-C

   FIRAppCheckDebugProviderFactory *providerFactory =
         [[FIRAppCheckDebugProviderFactory alloc] init];
   [FIRAppCheck setAppCheckProviderFactory:providerFactory];
   
   // Use Firebase library to configure APIs
   [FIRApp configure];

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

   <Warning> [AppCheckCore][I-GAC004001] App Check debug token:
   '123a4567-b89c-12d3-e456-789012345678'.

3. في Firebase Console، انتقِل إلى الأمان > التحقّق من التطبيقات > التطبيقات.

4. سجِّل الرمز المميّز لتصحيح الأخطاء الذي سجّلته للتو.

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

   

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

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

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

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

1. في Firebase Console، انتقِل إلى الأمان > التحقّق من التطبيقات > التطبيقات.

2. أنشِئ رمزًا مميّزًا لتصحيح الأخطاء. ستحتاج إلى هذا الرمز المميّز في الخطوة التالية.

   1. من قائمة التطبيق الإضافية، اختَر إدارة الرموز المميّزة لتصحيح الأخطاء.
   2. اتّبِع التعليمات الظاهرة على الشاشة لإنشاء رمز مميّز جديد لتصحيح الأخطاء.

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

   

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

4. إذا لزم الأمر، اضبط نظام التكامل المستمر لجعل الرمز المميّز لتصحيح الأخطاء متاحًا في بيئة التكامل المستمر كمتغيّر بيئة. امنح المتغيّر اسمًا، مثل APP_CHECK_DEBUG_TOKEN_FROM_CI.

5. في Xcode، أضِف متغيّر بيئة إلى مخطط الاختبار باسم AppCheckDebugToken وقيمة، مثل $(APP_CHECK_DEBUG_TOKEN).

6. اضبط نص اختبار التكامل المستمر لتمرير الرمز المميّز لتصحيح الأخطاء كمتغيّر بيئة. على سبيل المثال:

   xcodebuild test -scheme YourTestScheme -workspace YourProject.xcworkspace \
   APP_CHECK_DEBUG_TOKEN=$(APP_CHECK_DEBUG_TOKEN_FROM_CI)

7. في إصدار تصحيح الأخطاء، قبل استخدام أيّ من خدمات Firebase للواجهة الخلفية، أنشِئ واضبط المصنع الخاص بموفّر تصحيح الأخطاء في ميزة "التحقّق من التطبيقات":App Check

   Swift

   let providerFactory = AppCheckDebugProviderFactory()
   AppCheck.setAppCheckProviderFactory(providerFactory)
   
   FirebaseApp.configure()

   Objective-C

   FIRAppCheckDebugProviderFactory *providerFactory =
         [[FIRAppCheckDebugProviderFactory alloc] init];
   [FIRAppCheck setAppCheckProviderFactory:providerFactory];
   
   // Use Firebase library to configure APIs
   [FIRApp configure];

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