بدء استخدام App Check لتسجيل الدخول بحساب Google على أجهزة iOS

توضّح لك هذه الصفحة كيفية تفعيل ميزة "فحص التطبيقات" في تطبيق iOS. عند تفعيل التطبيق يُرجى التأكّد من أنّ تطبيقك وحده يمكنه الوصول إلى OAuth 2.0 من Google. والنقاط النهائية نيابة عن مشروعك. اطّلِع على نظرة عامة حول هذه الميزة.

تستخدم ميزة "فحص التطبيقات" ميزة App Attest للمساعدة في التحقق من أنّ OAuth 2.0 يتم طلبها من تطبيقك الأصلي. لا تستخدم ميزة "التحقّق من التطبيقات" ميزة App Attest لتحليل مخاطر الاحتيال.

قبل البدء

1. تأكّد من توفُّر Xcode 12.5 أو إصدار أحدث.

2. ادمج "تسجيل الدخول بحساب Google" في تطبيق iOS، باستخدام مكتبة "تسجيل الدخول بحساب Google"

1. إعداد مشروعك

1. يجب أن يكون لديك مشروع في Firebase لاستخدام ميزة "فحص التطبيقات" مع تسجيل الدخول باستخدام حساب Google.

   • إذا كان تطبيقك يستخدم Firebase حاليًا، استخدِم المشروع نفسه.

   • إذا كان تطبيقك يستخدم "تسجيل الدخول بحساب Google" وليس Firebase، يعني هذا أنّ لديك مشروع Google Cloud. إضافة Firebase إلى مشروعك على Google Cloud بحلول تحديده عند إنشاء مشروع جديد في وحدة تحكُّم Firebase

   راجِع أيضًا: العلاقة بين مشاريع Firebase وGoogle Cloud

2. أضِف تطبيقات iOS إلى مشروع Firebase، في حال لم يسبق لك إجراء ذلك. باستخدام صفحة إعدادات المشروع في وحدة تحكُّم Firebase.

3. سجِّل تطبيقاتك لاستخدام ميزة "فحص التطبيقات" مع موفِّر خدمة App Attest في قسم فحص التطبيقات في "وحدة تحكُّم Firebase".

   ملاحظة: لا يؤثِّر إعداد مدة صلاحية الرمز المميّز في عملية "فحص التطبيق". الرموز المميزة المستخدمة في تسجيل الدخول بحساب Google. تم الحصول على تأكيد جديد لـ "مصادقة التطبيق" قبل كل تفاعل مع نقاط نهاية OAuth 2.0 من Google.

4. تأكَّد من ربط جميع عملاء OAuth لمشروعك بأحد التطبيقات.

   في حال إلغاء ربط برامج، ستظهر لك رسالة في هوية Google. لنظام التشغيل iOS من صفحة فحص التطبيق الذي يفيد، لديك هناك n عميل OAuth غير مرتبط يتطلب إعدادًا إضافيًا.

   بالإضافة إلى ذلك، إذا حذفت بعض عملاء OAuth بعد إعدادها. في فحص التطبيقات، سيتم عرض رسالة مفادها: لديك n الإلغاء بدون عميل OAuth مطابق. يمكنك التنظيف بأمان من خلال حذف تلك التجاوزات.

   يمكنك ربط العملاء الذين تم إلغاء ربطهم بتطبيق حالي أو جديد على صفحة برامج OAuth في وحدة تحكُّم Firebase.

2. إضافة مكتبة "تسجيل الدخول باستخدام حساب Google" التجريبية إلى تطبيقك

1. في مشروع Xcode، اضبط الاعتمادية "تسجيل الدخول بحساب Google" على الإصدار. 7.1.0-fac-beta-1.1.0:

   مدير شركاء استراتيجي

   اضبط قاعدة التبعية googlesignin-ios على الإصدار الدقيق: 7.1.0-fac-beta-1.1.0

   CocoaPods

   تحديث Podfile:

   source 'https://github.com/CocoaPods/Specs.git'
   source 'https://github.com/firebase/SpecsDev.git'
   
   target 'YourAppName' do
     use_frameworks!
   
     pod 'GoogleSignIn',
         :git => 'https://github.com/google/GoogleSignIn-iOS.git',
         :tag => '7.1.0-fac-beta-1.1.0'
     pod 'GoogleSignInSwiftSupport'  # If you use SwiftUI.
   end
   

   بعد ذلك، شغِّل pod install وافتح ملف .xcworkspace الذي تم إنشاؤه.

2. في Xcode، أضِف ميزة App Attest إلى تطبيقك.

3. في ملف .entitlements الخاص بمشروعك، اضبط بيئة App Attest على production

   ملاحظة: لا تقبل ميزة "فحص التطبيق" الرموز المميّزة التي تم إنشاؤها في وضع الحماية "مصادقة التطبيق". بيئتك.

3- إعداد فحص التطبيقات

يمكنك إدخال طلب، وذلك من خلال طريقة didFinishLaunchingWithOptions التي يستخدمها مفوَّض تطبيقك GIDSignIn.sharedInstance.configure(completion:) يجب عليك استدعاء هذه الطريقة في أقرب وقت ممكن خلال مراحل نشاط تطبيقك لتقليل وقت الاستجابة الذي يلاحظه المستخدمون.

ملاحظة: يؤدي الاتصال بـ GIDSignIn.sharedInstance.configure(completion:) إلى إعداد التطبيق تحقّق من الاستخدام في مرحلة الإنتاج. عند إنشاء تطبيقك للاختبار وتصحيح الأخطاء الاتصال بخدمة GIDSignIn.sharedInstance.configureDebugProvider(withAPIKey:completion:) راجِع مقالة استخدام ميزة "فحص التطبيق" مع موفِّر تصحيح الأخطاء.

import SwiftUI
import GoogleSignIn

class AppDelegate: NSObject, UIApplicationDelegate {
  func application(
    _ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil
  ) -> Bool {
    #if targetEnvironment(simulator)
    // Configure for debugging.
    // See: https://developers.google.com/identity/sign-in/ios/appcheck/debug-provider
    #else
    GIDSignIn.sharedInstance.configure { error in
      if let error {
        print("Error configuring `GIDSignIn` for Firebase App Check: \(error)")
      }
    }
    #endif

    return true
  }
}

@main
struct YourAppNameApp: App {
  @UIApplicationDelegateAdaptor(AppDelegate.self) var appDelegate

  // ...
}

الخطوات التالية

بعد تثبيت مكتبة "فحص التطبيقات" في تطبيقك، ابدأ في توزيع تحديث التطبيق للمستخدمين لديك.

ملاحظة: في حال إضافة "إثبات ملكية التطبيق" إلى تطبيق إنتاجية يضم عددًا كبيرًا من المستخدمين النشطين الأساسية، تنصح Apple بإعداد المستخدمين تدريجيًا لتفادي تجاوز حدود الحصة.

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

مراقبة المقاييس

ومع ذلك، قبل تفعيل التنفيذ، يجب التأكّد من أنّ ذلك لن يؤدي إلى تعطيل المستخدمين الشرعيين الحاليين من ناحية أخرى، إذا رأيت أي استخدام مريب لموارد تطبيقك، قد تحتاج إلى تفعيل إجراءات التنفيذ قريبًا.

للمساعدة في اتخاذ هذا القرار، يمكنك إلقاء نظرة على مقاييس فحص التطبيقات لتسجيل الدخول باستخدام حساب Google

تفعيل فرض فحص التطبيقات

عندما تفهم تأثير فحص التطبيقات على المستخدمين وكنت مستعدًا لذلك للمتابعة، يمكنك تفعيل تنفيذ ميزة "التحقّق من التطبيقات".

استخدام ميزة "فحص التطبيقات" في بيئات تصحيح الأخطاء

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

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