استخدام ميزة "فحص التطبيقات" مع موفِّر تصحيح الأخطاء على أنظمة 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. من القائمة الكاملة لتطبيقك، اختَر إدارة رموز تصحيح الأخطاء.
   3. اتّبِع التعليمات الظاهرة على الشاشة لتسجيل رمز تصحيح الأخطاء.

   

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

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

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

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

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

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

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

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

   

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

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

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

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

   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];

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