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

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

قبل ان تبدأ

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

  1. في Xcode، مع فتح مشروع التطبيق الخاص بك، انتقل إلى File > Add Packages .
  2. عندما يُطلب منك ذلك، قم بإضافة مستودع Firebase Apple الأساسي لـ SDK:
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. اختر مكتبة مصادقة Firebase.
  5. أضف علامة -ObjC إلى قسم إشارات الرابط الأخرى في إعدادات إنشاء هدفك.
  6. عند الانتهاء، سيبدأ 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 إلى تطبيقك.

سويفت

import FirebaseCore
import FirebaseAuth
import GoogleSignIn

ج موضوعية

@import FirebaseCore;
@import GoogleSignIn;

تنفيذ تسجيل الدخول إلى Google

قم بتنفيذ تسجيل الدخول بحساب Google باتباع الخطوات التالية. راجع وثائق مطور تسجيل الدخول بحساب Google للحصول على تفاصيل حول استخدام تسجيل الدخول بحساب Google مع نظام التشغيل iOS.

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

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

  2. في تطبيق مندوب تطبيقك application:didFinishLaunchingWithOptions: قم بتكوين كائن FirebaseApp .

    سويفت

    FirebaseApp.configure()
    

    ج موضوعية

    // Use Firebase library to configure APIs
    [FIRApp configure];
    
  3. قم بتنفيذ application:openURL:options: طريقة مندوب التطبيق الخاص بك. يجب أن تستدعي الطريقة طريقة handleURL لمثيل GIDSignIn ، والتي ستتعامل بشكل صحيح مع عنوان URL الذي يتلقاه تطبيقك في نهاية عملية المصادقة.

    سويفت

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

    ج موضوعية

    - (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 الناتج:

    سويفت

    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)
    
      // ...
    }
    

    ج موضوعية

    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 .
  6. اختياري : إذا كنت تريد تخصيص الزر، فقم بما يلي:

    سويفت

    1. في وحدة تحكم العرض الخاصة بك، قم بتعريف زر تسجيل الدخول كخاصية.
      @IBOutlet weak var signInButton: GIDSignInButton!
    2. قم بتوصيل الزر بخاصية signInButton التي أعلنتها للتو.
    3. قم بتخصيص الزر عن طريق تعيين خصائص كائن GIDSignInButton .

    ج موضوعية

    1. في ملف رأس وحدة التحكم في العرض، قم بتعريف زر تسجيل الدخول كخاصية.
      @property(weak, nonatomic) IBOutlet GIDSignInButton *signInButton;
    2. قم بتوصيل الزر بخاصية signInButton التي أعلنتها للتو.
    3. قم بتخصيص الزر عن طريق تعيين خصائص كائن GIDSignInButton .

المصادقة مع Firebase

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

سويفت

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

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

ج موضوعية

[[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 وقواعد أمان التخزين السحابي، يمكنك الحصول على معرف المستخدم الفريد للمستخدم الذي قام بتسجيل الدخول من متغير auth ، واستخدامه للتحكم في البيانات التي يمكن للمستخدم الوصول إليها.

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

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

سويفت

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

ج موضوعية

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

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