ตรวจสอบสิทธิ์โดยใช้ Google Sign-In บนแพลตฟอร์ม Apple

คุณสามารถอนุญาตให้ผู้ใช้ตรวจสอบสิทธิ์กับ Firebase โดยใช้บัญชี Google ของตนได้โดยการผสานรวม Google Sign-In เข้ากับแอปของคุณ

ก่อนที่คุณจะเริ่ม

ใช้ Swift Package Manager เพื่อติดตั้งและจัดการการพึ่งพา Firebase

  1. ใน Xcode เมื่อโปรเจ็กต์แอปของคุณเปิดอยู่ ให้ไปที่ File > Add Package
  2. เมื่อได้รับแจ้ง ให้เพิ่มพื้นที่เก็บข้อมูล SDK แพลตฟอร์ม Firebase Apple:
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. เลือกไลบรารี Firebase Authentication
  5. เพิ่มแฟล็ก -ObjC ไปยังส่วน Other Linker Flags ของการตั้งค่า build ของเป้าหมายของคุณ
  6. เมื่อเสร็จแล้ว Xcode จะเริ่มแก้ไขและดาวน์โหลดการอ้างอิงของคุณโดยอัตโนมัติในเบื้องหลัง

เพิ่ม Google Sign-In SDK ในโครงการของคุณ

  1. ใน Xcode เมื่อโปรเจ็กต์แอปของคุณเปิดอยู่ ให้ไปที่ File > Add Package

  2. เมื่อได้รับแจ้ง ให้เพิ่มที่เก็บ Google Sign-In SDK:

    https://github.com/google/GoogleSignIn-iOS
    
  3. เมื่อเสร็จแล้ว Xcode จะเริ่มแก้ไขและดาวน์โหลดการอ้างอิงของคุณโดยอัตโนมัติในเบื้องหลัง

เปิดใช้งาน Google Sign-In สำหรับโปรเจ็กต์ Firebase ของคุณ

หากต้องการอนุญาตให้ผู้ใช้ลงชื่อเข้าใช้ด้วย Google Sign-In คุณต้องเปิดใช้งานผู้ให้บริการ Google Sign-In สำหรับโปรเจ็กต์ 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

วัตถุประสงค์-C

@import FirebaseCore;
@import GoogleSignIn;

ใช้การลงชื่อเข้าใช้ Google

ใช้ Google Sign-In โดยทำตามขั้นตอนเหล่านี้ ดู เอกสารสำหรับนักพัฒนา Google Sign-In สำหรับรายละเอียดเกี่ยวกับการใช้ Google Sign-In กับ iOS

  1. เพิ่มโครงร่าง URL ที่กำหนดเองให้กับโปรเจ็กต์ Xcode ของคุณ:
    1. เปิดการกำหนดค่าโครงการของคุณ: คลิกชื่อโครงการในมุมมองต้นไม้ด้านซ้าย เลือกแอปของคุณจากส่วน เป้าหมาย จากนั้นเลือกแท็บ ข้อมูล และขยายส่วน ประเภท URL
    2. คลิกปุ่ม + และเพิ่มรูปแบบ URL สำหรับรหัสไคลเอ็นต์ที่กลับรายการของคุณ หากต้องการค้นหาค่านี้ ให้เปิดไฟล์การกำหนดค่า GoogleService-Info.plist และมองหาคีย์ REVERSED_CLIENT_ID คัดลอกค่าของคีย์นั้น และวางลงในกล่อง URL Schemes บนหน้าการกำหนดค่า ปล่อยให้ช่องอื่นๆ ไม่ถูกแตะต้อง

      เมื่อเสร็จแล้ว การกำหนดค่าของคุณควรมีลักษณะคล้ายกับตัวอย่างต่อไปนี้ (แต่ด้วยค่าเฉพาะแอปพลิเคชันของคุณ):

  2. ในเมธอด application:didFinishLaunchingWithOptions: ของผู้รับมอบสิทธิ์แอปของคุณ ให้กำหนดค่าออบเจ็กต์ FirebaseApp

    สวิฟท์

    FirebaseApp.configure()
    

    วัตถุประสงค์-C

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

    วัตถุประสงค์-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 ที่เป็นผลลัพธ์:

    สวิฟท์

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

    วัตถุประสงค์-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
  6. ทางเลือก : หากคุณต้องการปรับแต่งปุ่ม ให้ทำดังต่อไปนี้:

    สวิฟท์

    1. ในตัวควบคุมมุมมองของคุณ ให้ประกาศปุ่มลงชื่อเข้าใช้เป็นคุณสมบัติ
      @IBOutlet weak var signInButton: GIDSignInButton!
    2. เชื่อมต่อปุ่มกับคุณสมบัติ signInButton ที่คุณเพิ่งประกาศ
    3. ปรับแต่งปุ่มโดยการตั้งค่าคุณสมบัติของวัตถุ GIDSignInButton

    วัตถุประสงค์-C

    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
}
    

วัตถุประสงค์-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 และ กฎความปลอดภัยของ พื้นที่เก็บข้อมูลบนคลาวด์ คุณสามารถรับ ID ผู้ใช้เฉพาะของผู้ใช้ที่ลงชื่อเข้าใช้จากตัวแปร auth และใช้เพื่อควบคุมข้อมูลที่ผู้ใช้สามารถเข้าถึงได้

คุณสามารถอนุญาตให้ผู้ใช้ลงชื่อเข้าใช้แอปของคุณโดยใช้ผู้ให้บริการตรวจสอบสิทธิ์หลายรายได้โดย การเชื่อมโยงข้อมูลประจำตัวของผู้ให้บริการตรวจสอบสิทธิ์กับบัญชีผู้ใช้ที่มีอยู่

หากต้องการออกจากระบบผู้ใช้ ให้โทร signOut:

สวิฟท์

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

วัตถุประสงค์-C

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

คุณอาจต้องการเพิ่มรหัสการจัดการข้อผิดพลาดสำหรับข้อผิดพลาดในการรับรองความถูกต้องทั้งหมด ดู การจัดการข้อผิดพลาด