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 tính năng Đă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 Firebase.
- Trong Xcode, khi dự án ứng dụng của bạn đang mở, hãy chuyển đến Tệp > Thêm gói.
- Khi được nhắc, hãy thêm kho lưu trữ SDK nền tảng Apple của Firebase:
- Chọn thư viện Firebase Authentication.
- Thêm cờ
-ObjC
vào mục Cờ trình liên kết khác trong chế độ cài đặt bản dựng của mục tiêu. - 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 trong nền.
https://github.com/firebase/firebase-ios-sdk.git
Thêm SDK đăng nhập bằng Google vào dự án của bạn
Trong Xcode, khi dự án ứng dụng của bạn đang mở, hãy chuyển đến Tệp > Thêm gói.
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
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 trong nền.
Bật tính năng Đă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 tính năng Đăng nhập bằng Google, trước tiên bạn phải bật Nhà cung cấp tính năng Đăng nhập bằng Google cho dự án Firebase của bạn:
- Trong bảng điều khiển Firebase, hãy mở phần Xác thực.
- Trên thẻ Phương thức đăng nhập, hãy bật nhà cung cấp Google.
Nhấp vào Lưu.
Tải bản sao mới của tệp
GoogleService-Info.plist
của dự án xuống và hãy sao chép tệp đó vào dự án Xcode của bạn. Ghi đè mọi phiên bản hiện có bằng một. (Xem bài viết Thêm Firebase vào iOS của bạn dự án.)
Nhập các tệp tiêu đề bắt buộc
Trước tiên, bạn phải nhập tệp tiêu đề SDK Firebase và SDK đăng nhập bằng Google vào ứng dụng của bạn.
Swift
import FirebaseCore import FirebaseAuth import GoogleSignIn
Objective-C
@import FirebaseCore; @import GoogleSignIn;
Triển khai tính năng Đăng nhập bằng Google
Triển khai chức năng Đăng nhập bằng Google bằng cách làm theo các bước sau. Xem phần Đăng nhập bằng Google tài liệu dành cho nhà phát triển để biết thông tin chi tiết về cách sử dụng Google Đăng nhập bằng iOS.
- Thêm giao thức URL tùy chỉnh vào dự án Xcode của bạn:
- Mở cấu hình dự án: nhấp vào tên dự án trong cây bên trái chế độ xem. Chọn ứng dụng của bạn trong mục MỤC TIÊU, sau đó chọn thẻ Thông tin rồi mở rộng mục Loại URL.
- Nhấp vào nút dấu + rồi thêm lược đồ URL cho thành phần đảo ngược
mã ứng dụng khách. Để tìm giá trị này, hãy mở
tệp cấu hình và tìm khoáGoogleService-Info.plist REVERSED_CLIENT_ID
. Sao chép giá trị của khoá đó, rồi dán mã đó vào hộp Lược đồ URL trên trang cấu hình. Giữ nguyên các trường khác.Sau khi hoàn tất, cấu hình của bạn sẽ có dạng như sau sau đây (nhưng với các giá trị dành riêng cho ứng dụng của bạn):
- Trong
application:didFinishLaunchingWithOptions:
của ứng dụng uỷ quyền hãy định cấu hình đối tượngFirebaseApp
.Swift
FirebaseApp.configure()
Objective-C
// Use Firebase library to configure APIs [FIRApp configure];
- Triển khai phương thức
application:openURL:options:
của ứng dụng người được uỷ quyền. Phương thức này sẽ gọi phương thứchandleURL
củaGIDSignIn
sẽ xử lý đúng cách URL mà mà ứng dụng của bạn nhận được khi kết thúc quá trình xác thực.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]; }
- Truyề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 đến
Phương thức
signIn
của trình cung cấp tính năng Đăng nhập bằng Google và tạo một Firebase Thông tin xác thực từ mã thông báo xác thực của Google thu được: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 { // ... } }];
- Thêm
GIDSignInButton
vào bảng phân cảnh, tệp XIB hoặc tạo thực thể theo phương thức lập trình. Để thêm nút vào bảng phân cảnh hoặc XIB hãy thêm Thành phần hiển thị và đặt lớp tuỳ chỉnh của thành phần hiển thị đó thànhGIDSignInButton
. - Không bắt buộc: Nếu bạn muốn tuỳ chỉnh nút này, hãy
sau:
Swift
- Trong bộ điều khiển chế độ xem, hãy khai báo nút đăng nhập dưới dạng một thuộc tính.
@IBOutlet weak var signInButton: GIDSignInButton!
- Kết nối nút này với thuộc tính
signInButton
mà bạn vừa tạo đã khai báo. - Tuỳ chỉnh nút này bằng cách đặt thuộc tính của nút GIDSignInButton.
Objective-C
- Trong tệp tiêu đề của trình điều khiển chế độ xem, hãy khai báo nút đăng nhập dưới dạng
thuộc tính này.
@property(weak, nonatomic) IBOutlet GIDSignInButton *signInButton;
- Kết nối nút này với thuộc tính
signInButton
mà bạn vừa tạo đã khai báo. - Tuỳ chỉnh nút này bằng cách đặt thuộc tính của nút GIDSignInButton.
- Trong bộ điều khiển chế độ xem, hãy khai báo nút đăng nhập dưới dạng một thuộc tính.
Xác thực bằng Firebase
Cuối cùng, hãy hoàn tất quy trình đăng nhập Firebase bằng thông tin xác thực đã tạo ở bước trước.
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; // ... }];
Các 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à được liên kết với thông tin đăng nhập—tức là tên người dùng và mật khẩu, số điện thoại số hoặc thông tin của nhà cung cấp dịch vụ xác thực – người dùng đã đăng nhập. Thông tin mới này được lưu trữ như một phần của dự án Firebase và có thể được dùng để xác định một 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ừ
User
. Xem phần Quản lý người dùng. Trong Firebase Realtime Database và Cloud Storage của bạn Quy tắc bảo mật, bạn có thể lấy mã nhận dạng người dùng duy nhất của người dùng đã đăng nhập từ biến
auth
, để kiểm soát loại dữ liệu mà 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 phương thức xác thực bằng cách liên kết thông tin đăng nhập của nhà cung cấp dịch vụ 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:
.
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; }
Bạn cũng nên thêm mã xử lý lỗi cho toàn bộ phạm vi xác thực . Hãy xem bài viết Xử lý lỗi.