Xác thực bằng cách đăng nhập bằng Google trên nền tảng Apple

Bạn có thể cho phép người dùng xác thực bằng Firebase bằng Tài khoản Google của họ bằng cách tích hợp Đăng nhập bằng Google vào ứng dụng của bạn.

Trước khi bắt đầu

Sử dụng Trình quản lý gói Swift để cài đặt và quản lý các phần phụ thuộc của Firebase.

  1. Trong Xcode, khi dự án ứng dụng của bạn đang mở, hãy điều hướng đến File > Add Packages .
  2. Khi được nhắc, hãy thêm kho lưu trữ SDK nền tảng Firebase của Apple:
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. Chọn thư viện Xác thực Firebase.
  5. Thêm cờ -ObjC vào phần Cờ liên kết khác trong cài đặt bản dựng của mục tiêu của bạn.
  6. Khi hoàn tất, Xcode sẽ tự động bắt đầu phân giải và tải xuống các phần phụ thuộc của bạn ở chế độ nền.

Thêm SDK đăng nhập bằng Google vào dự án của bạn

  1. Trong Xcode, khi dự án ứng dụng của bạn đang mở, hãy điều hướng đến File > Add Packages .

  2. Khi được nhắc, hãy thêm kho lưu trữ SDK đăng nhập bằng Google:

    https://github.com/google/GoogleSignIn-iOS
    
  3. Khi hoàn tất, Xcode sẽ tự động bắt đầu phân giải và tải xuống các phần phụ thuộc của bạn ở chế độ nền.

Bật Đăng nhập bằng Google cho dự án Firebase của bạn

Để cho phép người dùng đăng nhập bằng Đăng nhập bằng Google, trước tiên bạn phải bật nhà cung cấp Đăng nhập bằng Google cho dự án Firebase của mình:

  1. Trong bảng điều khiển Firebase , hãy mở phần Xác thực .
  2. Trên tab Phương thức đăng nhập , hãy bật nhà cung cấp Google .
  3. Nhấp vào để lưu .

  4. Tải xuống bản sao mới của tệp GoogleService-Info.plist của dự án và sao chép nó vào dự án Xcode của bạn. Ghi đè mọi phiên bản hiện có bằng phiên bản mới. (Xem Thêm Firebase vào dự án iOS của bạn .)

Nhập các tệp tiêu đề cần thiết

Trước tiên, bạn phải nhập SDK Firebase và tệp tiêu đề SDK đăng nhập Google vào ứng dụng của mình.

Nhanh

import FirebaseCore
import FirebaseAuth
import GoogleSignIn

Mục tiêu-C

@import FirebaseCore;
@import GoogleSignIn;

Triển khai đăng nhập bằng Google

Triển khai Đăng nhập bằng Google bằng cách làm theo các bước sau. Xem tài liệu dành cho nhà phát triển Đăng nhập bằng Google để biết chi tiết về cách sử dụng Đăng nhập bằng Google với iOS.

  1. Thêm lược đồ URL tùy chỉnh vào dự án Xcode của bạn:
    1. Mở cấu hình dự án của bạn: nhấp vào tên dự án ở chế độ xem dạng cây bên trái. Chọn ứng dụng của bạn từ phần MỤC TIÊU , sau đó chọn tab Thông tin và mở rộng phần Loại URL .
    2. Nhấp vào nút + và thêm lược đồ URL cho ID khách hàng đã đảo ngược của bạn. Để tìm giá trị này, hãy mở tệp cấu hình GoogleService-Info.plist và tìm khóa REVERSED_CLIENT_ID . Sao chép giá trị của khóa đó và dán vào hộp Lược đồ URL trên trang cấu hình. Để nguyên các lĩnh vực khác.

      Khi hoàn tất, cấu hình của bạn sẽ trông giống như sau (nhưng với các giá trị dành riêng cho ứng dụng của bạn):

  2. Trong application:didFinishLaunchingWithOptions: của đại biểu ứng dụng của bạn, hãy định cấu hình đối tượng FirebaseApp .

    Nhanh

    FirebaseApp.configure()
    

    Mục tiêu-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
    
  3. Triển khai phương thức application:openURL:options: của đại biểu ứng dụng của bạn. Phương thức này sẽ gọi phương thức handleURL của phiên bản GIDSignIn , phương thức này sẽ xử lý đúng cách URL mà ứng dụng của bạn nhận được khi kết thúc quá trình xác thực.

    Nhanh

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

    Mục tiêu-C

    - (BOOL)application:(nonnull UIApplication *)application
                openURL:(nonnull NSURL *)url
                options:(nonnull NSDictionary<NSString *, id> *)options {
      return [[GIDSignIn sharedInstance] handleURL:url];
    }
    
  4. Chuyển trình điều khiển chế độ xem trình bày và ID ứng dụng khách cho ứng dụng của bạn sang phương thức signIn của nhà cung cấp Đăng nhập bằng Google và tạo thông tin xác thực Xác thực Firebase từ mã thông báo xác thực Google thu được:

    Nhanh

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

    Mục tiêu-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. Thêm GIDSignInButton vào bảng phân cảnh, tệp XIB của bạn hoặc khởi tạo nó theo chương trình. Để thêm nút vào bảng phân cảnh hoặc tệp XIB của bạn, hãy thêm Chế độ xem và đặt lớp tùy chỉnh của nó thành GIDSignInButton .
  6. Tùy chọn : Nếu bạn muốn tùy chỉnh nút, hãy làm như sau:

    Nhanh

    1. Trong trình điều khiển chế độ xem của bạn, hãy khai báo nút đăng nhập làm thuộc tính.
      @IBOutlet weak var signInButton: GIDSignInButton!
    2. Kết nối nút với thuộc tính signInButton mà bạn vừa khai báo.
    3. Tùy chỉnh nút bằng cách đặt thuộc tính của đối tượng GIDSignInButton .

    Mục tiêu-C

    1. Trong tệp tiêu đề của trình điều khiển chế độ xem của bạn, hãy khai báo nút đăng nhập làm thuộc tính.
      @property(weak, nonatomic) IBOutlet GIDSignInButton *signInButton;
    2. Kết nối nút với thuộc tính signInButton mà bạn vừa khai báo.
    3. Tùy chỉnh nút bằng cách đặt thuộc tính của đối tượng GIDSignInButton .

Xác thực với Firebase

Cuối cùng, hoàn tất quy trình đăng nhập Firebase bằng thông tin xác thực được tạo ở bước trước.

Nhanh

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

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

Mục tiêu-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;
  // ...
}];

Bước tiếp theo

Sau khi người dùng đăng nhập lần đầu tiên, một tài khoản người dùng mới sẽ được tạo và liên kết với thông tin xác thực—tức là tên người dùng và mật khẩu, số điện thoại hoặc thông tin nhà cung cấp dịch vụ xác thực—mà người dùng đã đăng nhập. Tài khoản mới này được lưu trữ như một phần của dự án Firebase của bạn và có thể được sử dụng để xác định người dùng trên mọi ứng dụng trong dự án của bạn, bất kể người dùng đăng nhập bằng cách nào.

  • Trong ứng dụng của mình, bạn có thể lấy thông tin hồ sơ cơ bản của người dùng từ đối tượng User . Xem Quản lý người dùng .

  • Trong Quy tắc bảo mật cơ sở dữ liệu thời gian thực và lưu trữ đám mây của Firebase, bạn có thể lấy ID người dùng duy nhất của người dùng đã đăng nhập từ biến auth và sử dụng nó để kiểm soát dữ liệu nào người dùng có thể truy cập.

Bạn có thể cho phép người dùng đăng nhập vào ứng dụng của mình bằng nhiều nhà cung cấp xác thực bằng cách liên kết thông tin xác thực của nhà cung cấp xác thực với tài khoản người dùng hiện có.

Để đăng xuất một người dùng, hãy gọi signOut: .

Nhanh

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

Mục tiêu-C

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

Bạn cũng có thể muốn thêm mã xử lý lỗi cho đầy đủ các lỗi xác thực. Xem Xử lý lỗi .