المصادقة باستخدام تسجيل الدخول بحساب Google على أنظمة Apple الأساسية

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

قبل البدء

استخدِم أداة Swift Package Manager لتثبيت الموارد الاعتمادية في Firebase وإدارتها.

يمكنك الانتقال إلى دليل التثبيت للتعرّف على الطرق المختلفة التي يمكنك من خلالها إضافة حِزم تطوير البرامج (SDK) من Firebase إلى مشروع Apple، بما في ذلك استيراد الأُطر مباشرةً واستخدام CocoaPods.

1. في Xcode، بعد فتح مشروع تطبيقك، انتقِل إلى ملف (File) > إضافة حِزم (Add Packages).
2. عندما يُطلب منك ذلك، أضِف مستودع حزمة تطوير البرامج (SDK) لمنصة Firebase على أجهزة Apple:

  https://github.com/firebase/firebase-ios-sdk.git

ملاحظة: يجب أن تستخدم المشاريع الجديدة إصدار حزمة SDK التلقائي (الأحدث)، ولكن يمكنك اختيار إصدار أقدم إذا لزم الأمر.
3. اختَر مكتبة Firebase Authentication.
4. أضِف العلامة -ObjC إلى قسم علامات الربط الأخرى في إعدادات الإصدار الخاص بالكائن المستهدَف.
5. بعد الانتهاء، سيبدأ Xcode تلقائيًا في حلّ التبعيات وتنزيلها في الخلفية.

إضافة حزمة تطوير البرامج (SDK) لخدمة "تسجيل الدخول باستخدام Google" إلى مشروعك

1. في Xcode، بعد فتح مشروع تطبيقك، انتقِل إلى ملف (File) > إضافة حِزم (Add Packages).

2. عندما يُطلب منك ذلك، أضِف مستودع حزمة تطوير البرامج (SDK) لخدمة "تسجيل الدخول باستخدام Google":

   https://github.com/google/GoogleSignIn-iOS
   

3. عند الانتهاء، سيبدأ Xcode تلقائيًا في حلّ التبعيات وتنزيلها في الخلفية.

تفعيل ميزة "تسجيل الدخول باستخدام Google" لمشروعك على Firebase

للسماح للمستخدمين بتسجيل الدخول باستخدام ميزة "تسجيل الدخول باستخدام Google"، يجب أولاً تفعيل موفّر خدمة "تسجيل الدخول باستخدام Google" لمشروعك على Firebase:

1. في وحدة تحكّم Firebase، افتح قسم المصادقة.
2. في علامة التبويب طريقة تسجيل الدخول، فعِّل موفّر Google.

3. انقر على حفظ.

4. نزِّل نسخة جديدة من ملف GoogleService-Info.plist الخاص بمشروعك وانسخها إلى مشروع Xcode. استبدِل أي إصدارات حالية بالإصدار الجديد. (راجِع مقالة إضافة Firebase إلى مشروع iOS).

استيراد ملفات العناوين المطلوبة

أولاً، يجب استيراد ملفات عناوين Firebase SDK وGoogle Sign-In SDK إلى تطبيقك.

Swift

import FirebaseCore
import FirebaseAuth
import GoogleSignIn

Objective-C

@import FirebaseCore;
@import GoogleSignIn;

تنفيذ ميزة "تسجيل الدخول باستخدام حساب Google"

نفِّذ ميزة "تسجيل الدخول باستخدام حساب Google" باتّباع الخطوات التالية. راجِع مستندات المطوّرين حول خدمة "تسجيل الدخول باستخدام Google" لمعرفة تفاصيل حول استخدام هذه الخدمة مع نظام التشغيل iOS.

1. أضِف مخططات عناوين URL المخصّصة إلى مشروع Xcode باتّباع الخطوات التالية:
1. افتح إعدادات مشروعك: انقر على اسم المشروع في العرض التدرّجي على يمين الصفحة. اختَر تطبيقك من قسم الاستهدافات، ثم اختَر علامة التبويب المعلومات، ووسِّع قسم أنواع عناوين URL.
2. انقر على الزر +، وأضِف مخطط عنوان URL لمعرّف العميل المعكوس. للعثور على هذه القيمة، افتح ملف الإعداد GoogleService-Info.plist وابحث عن المفتاح REVERSED_CLIENT_ID. انسخ قيمة هذا المفتاح، والصِقها في مربّع مخططات عناوين URL في صفحة الإعداد. لا تُجري أي تغييرات على الحقول الأخرى.

   عند الانتهاء، من المفترض أن تبدو إعداداتك مشابهة لما يلي (ولكن مع القيم الخاصة بتطبيقك):

   
2. في طريقة application:didFinishLaunchingWithOptions: في مفوّض تطبيقك، اضبط عنصر FirebaseApp.

   Swift

   FirebaseApp.configure()

   Objective-C

   // Use Firebase library to configure APIs
   [FIRApp configure];

3. نفِّذ طريقة application:openURL:options: لمندوب تطبيقك. يجب أن تستدعي الطريقة طريقة handleURL الخاصة بكائن GIDSignIn، والتي ستتعامل بشكل صحيح مع عنوان URL الذي يتلقّاه تطبيقك في نهاية عملية المصادقة.

   Swift

   func application(_ app: UIApplication,
                    open url: URL,
                    options: [UIApplication.OpenURLOptionsKey: Any] = [:]) -> Bool {
     return GIDSignIn.sharedInstance.handle(url)
   }

   Objective-C

   - (BOOL)application:(nonnull UIApplication *)application
               openURL:(nonnull NSURL *)url
               options:(nonnull NSDictionary<NSString *, id> *)options {
     return [[GIDSignIn sharedInstance] handleURL:url];
   }

4. مرِّر وحدة التحكّم في العرض التقديمي ومعرّف العميل لتطبيقك إلى طريقة signIn لمقدّم خدمة "تسجيل الدخول باستخدام حساب Google"، وأنشئ بيانات اعتماد مصادقة Firebase من رمز مصادقة Google الناتج:

   Swift

   guard let clientID = FirebaseApp.app()?.options.clientID else { return }
   
   // Create Google Sign In configuration object.
   let config = GIDConfiguration(clientID: clientID)
   GIDSignIn.sharedInstance.configuration = config
   
   // Start the sign in flow!
   GIDSignIn.sharedInstance.signIn(withPresenting: self) { [unowned self] result, error in
     guard error == nil else {
       // ...
     }
   
     guard let user = result?.user,
       let idToken = user.idToken?.tokenString
     else {
       // ...
     }
   
     let credential = GoogleAuthProvider.credential(withIDToken: idToken,
                                                    accessToken: user.accessToken.tokenString)
   
     // ...
   }

   Objective-C

   GIDConfiguration *config = [[GIDConfiguration alloc] initWithClientID:[FIRApp defaultApp].options.clientID];
   [GIDSignIn.sharedInstance setConfiguration:config];
   
   __weak __auto_type weakSelf = self;
   [GIDSignIn.sharedInstance signInWithPresentingViewController:self
         completion:^(GIDSignInResult * _Nullable result, NSError * _Nullable error) {
     __auto_type strongSelf = weakSelf;
     if (strongSelf == nil) { return; }
   
     if (error == nil) {
       FIRAuthCredential *credential =
       [FIRGoogleAuthProvider credentialWithIDToken:result.user.idToken.tokenString
                                        accessToken:result.user.accessToken.tokenString];
       // ...
     } else {
       // ...
     }
   }];

5. أضِف GIDSignInButton إلى مخطط القصة أو ملف XIB أو أنشئ مثيلاً له آليًا. لإضافة الزر إلى لوحة العرض أو ملف XIB، أضِف عرضًا واضبط فئته المخصّصة على GIDSignInButton.
   عند إضافة عرض GIDSignInButton إلى لوحة العرض، لا يظهر زر تسجيل الدخول في أداة إنشاء واجهة المستخدم. شغِّل التطبيق للاطّلاع على زر تسجيل الدخول.
6. اختياري: إذا أردت تخصيص الزر، اتّبِع الخطوات التالية:

   Swift

   1. في وحدة التحكّم في العرض، عرِّف زر تسجيل الدخول كسمة.

      @IBOutlet weak var signInButton: GIDSignInButton!

   2. اربط الزرّ بالموقع signInButton الذي أضفته للتوّ.
   3. خصِّص الزر من خلال ضبط خصائص العنصر GIDSignInButton.

   Objective-C

   1. في ملف العنوان الخاص بوحدة التحكّم في العرض، عرِّف زر تسجيل الدخول كخاصية.

      @property(weak, nonatomic) IBOutlet GIDSignInButton *signInButton;

   2. اربط الزرّ بالموقع signInButton الذي أضفته للتوّ.
   3. خصِّص الزر من خلال ضبط خصائص العنصر GIDSignInButton.

المصادقة باستخدام Firebase

أخيرًا، أكمِل عملية تسجيل الدخول إلى Firebase باستخدام بيانات اعتماد المصادقة التي تم إنشاؤها في الخطوة السابقة.

Swift

Auth.auth().signIn(with: credential) { result, error in

  // At this point, our user is signed in
}
    

Objective-C

[[FIRAuth auth] signInWithCredential:credential
                          completion:^(FIRAuthDataResult * _Nullable authResult,
                                       NSError * _Nullable error) {
    if (isMFAEnabled && error && error.code == FIRAuthErrorCodeSecondFactorRequired) {
      FIRMultiFactorResolver *resolver = error.userInfo[FIRAuthErrorUserInfoMultiFactorResolverKey];
      NSMutableString *displayNameString = [NSMutableString string];
      for (FIRMultiFactorInfo *tmpFactorInfo in resolver.hints) {
        [displayNameString appendString:tmpFactorInfo.displayName];
        [displayNameString appendString:@" "];
      }
      [self showTextInputPromptWithMessage:[NSString stringWithFormat:@"Select factor to sign in\n%@", displayNameString]
                           completionBlock:^(BOOL userPressedOK, NSString *_Nullable displayName) {
       FIRPhoneMultiFactorInfo* selectedHint;
       for (FIRMultiFactorInfo *tmpFactorInfo in resolver.hints) {
         if ([displayName isEqualToString:tmpFactorInfo.displayName]) {
           selectedHint = (FIRPhoneMultiFactorInfo *)tmpFactorInfo;
         }
       }
       [FIRPhoneAuthProvider.provider
        verifyPhoneNumberWithMultiFactorInfo:selectedHint
        UIDelegate:nil
        multiFactorSession:resolver.session
        completion:^(NSString * _Nullable verificationID, NSError * _Nullable error) {
          if (error) {
            [self showMessagePrompt:error.localizedDescription];
          } else {
            [self showTextInputPromptWithMessage:[NSString stringWithFormat:@"Verification code for %@", selectedHint.displayName]
                                 completionBlock:^(BOOL userPressedOK, NSString *_Nullable verificationCode) {
             FIRPhoneAuthCredential *credential =
                 [[FIRPhoneAuthProvider provider] credentialWithVerificationID:verificationID
                                                              verificationCode:verificationCode];
             FIRMultiFactorAssertion *assertion = [FIRPhoneMultiFactorGenerator assertionWithCredential:credential];
             [resolver resolveSignInWithAssertion:assertion completion:^(FIRAuthDataResult * _Nullable authResult, NSError * _Nullable error) {
               if (error) {
                 [self showMessagePrompt:error.localizedDescription];
               } else {
                 NSLog(@"Multi factor finanlize sign in succeeded.");
               }
             }];
           }];
          }
        }];
     }];
    }
  else if (error) {
    // ...
    return;
  }
  // User successfully signed in. Get user data from the FIRUser object
  if (authResult == nil) { return; }
  FIRUser *user = authResult.user;
  // ...
}];

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

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

• في تطبيقاتك، يمكنك الحصول على معلومات الملف الشخصي الأساسية للمستخدم من عنصر User . راجِع مقالة إدارة المستخدمين.

• في Firebase Realtime Database وCloud Storage قواعد الأمان، يمكنك الحصول على معرّف المستخدِم الفريد للمستخدِم الذي سجّل الدخول من المتغيّر auth، واستخدامه للتحكّم في البيانات التي يمكن للمستخدِم الوصول إليها.

يمكنك السماح للمستخدمين بتسجيل الدخول إلى تطبيقك باستخدام موفّري مصادقة متعدّدين من خلال ربط بيانات اعتماد موفّر المصادقة بحساب مستخدم حالي.

لتسجيل خروج مستخدم، اتّصِل بالرقم signOut:.

Swift

let firebaseAuth = Auth.auth()
do {
  try firebaseAuth.signOut()
} catch let signOutError as NSError {
  print("Error signing out: %@", signOutError)
}

Objective-C

NSError *signOutError;
BOOL status = [[FIRAuth auth] signOut:&signOutError];
if (!status) {
  NSLog(@"Error signing out: %@", signOutError);
  return;
}

يمكنك أيضًا إضافة رمز معالجة الأخطاء لنطاق أخطاء المصادقة الكامل. يُرجى الاطّلاع على التعامل مع الأخطاء.