استخدام ميزة "فحص التطبيقات" مع موفِّر تصحيح الأخطاء على أنظمة 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. فعِّل ميزة تسجيل معلومات تصحيح الأخطاء في مشروع Xcode (الإصدار 11.0 أو أحدث):

    1. افتح المنتج (Product) > المخطّط (Scheme) > تعديل المخطّط (Edit scheme).
    2. انقر على تشغيل (Run) من القائمة على يمين الصفحة، ثم انقر على علامة التبويب المَعلمات (Arguments).
    3. في قسم المَعلمات التي تم ضبطها عند الإطلاق (Arguments Passed on Launch) ، أضِف -FIRDebugEnabled.

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

    [Firebase/AppCheck][I-FAA001001] Firebase App Check Debug Token:
123a4567-b89c-12d3-e456-789012345678

  4. في Firebase Console، انتقِل إلى الأمان (Security) > فحص التطبيقات (App Check).

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

    1. في علامة التبويب التطبيقات (Apps) ، ابحث عن تطبيقك.
    2. من القائمة الكاملة لتطبيقك، انقر على إدارة رموز تصحيح الأخطاء (Manage debug tokens).
    3. اتّبِع التعليمات الظاهرة على الشاشة لتسجيل رمز تصحيح الأخطاء.

    لقطة شاشة لعنصر القائمة "إدارة رموز تصحيح الأخطاء"

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

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

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

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

  1. في Firebase Console، انتقِل إلى الأمان (Security) > فحص التطبيقات (App Check).

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

    1. في علامة التبويب التطبيقات (Apps) ، ابحث عن تطبيقك.
    2. من القائمة الكاملة لتطبيقك، انقر على إدارة رموز تصحيح الأخطاء (Manage debug tokens).
    3. اتّبِع التعليمات الظاهرة على الشاشة لإنشاء رمز تصحيح أخطاء جديد.

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

    لقطة شاشة لعنصر القائمة "إدارة رموز تصحيح الأخطاء"

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

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

  5. في Xcode، أضِف متغيّر بيئة إلى مخطط الاختبار باسم FIRAAppCheckDebugToken وقيمة، مثل $(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 للواجهة الخلفية الرمز الذي ترسله على أنّه صالح.