Xác thực bằng Firebase trên các nền tảng của Apple bằng số điện thoại

Bạn có thể sử dụng Firebase Authentication để đăng nhập cho người dùng bằng cách gửi tin nhắn SMS đến điện thoại của người dùng. Người dùng đăng nhập bằng mã một lần có trong tin nhắn SMS.

Cách dễ nhất để thêm tính năng đăng nhập bằng số điện thoại vào ứng dụng là sử dụng FirebaseUI. FirebaseUI bao gồm một tiện ích đăng nhập thả xuống triển khai quy trình đăng nhập bằng số điện thoại, cũng như đăng nhập dựa trên mật khẩu và đăng nhập liên kết. Tài liệu này mô tả cách triển khai quy trình đăng nhập bằng số điện thoại bằng SDK Firebase.

Google sẽ gửi và lưu trữ số điện thoại mà người dùng cuối cung cấp để xác thực nhằm cải thiện khả năng ngăn chặn thư rác và hành vi sai trái trên các dịch vụ của Google, bao gồm nhưng không giới hạn ở Firebase. Nhà phát triển phải đảm bảo rằng họ có sự đồng ý thích hợp của người dùng cuối trước khi sử dụng dịch vụ đăng nhập bằng số điện thoại Firebase Authentication.

Trước khi bắt đầu

1. Nếu bạn chưa kết nối ứng dụng với dự án Firebase, hãy thực hiện việc này trong bảng điều khiển Firebase.

2. 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.

   Truy cập hướng dẫn cài đặt của chúng tôi để tìm hiểu về các cách thêm SDK Firebase vào dự án Apple, bao gồm cả việc nhập trực tiếp khung và sử dụng CocoaPods.
   1. Trong Xcode, khi dự án ứng dụng đang mở, hãy chuyển đến File > Add Packages (Tệp > Thêm gói).
   2. Khi được nhắc, hãy thêm kho lưu trữ SDK của các nền tảng Apple Firebase:

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

   Lưu ý: Các dự án mới nên sử dụng phiên bản SDK mặc định (mới nhất), nhưng bạn có thể chọn một phiên bản cũ hơn nếu cần.
   3. Chọn thư viện Firebase Authentication.
   4. Thêm cờ -ObjC vào phần Other Linker Flags (Cờ trình liên kết khác) trong phần cài đặt bản dựng của mục tiêu.
   5. Khi hoàn tất, Xcode sẽ tự động bắt đầu phân giải và tải các phần phụ thuộc xuống ở chế độ nền.

Các mối lo ngại về bảo mật

Mặc dù thuận tiện, nhưng việc xác thực chỉ bằng số điện thoại lại kém an toàn hơn so với các phương thức hiện có khác, vì quyền sở hữu số điện thoại có thể dễ dàng được chuyển giữa các người dùng. Ngoài ra, trên các thiết bị có nhiều hồ sơ người dùng, bất kỳ người dùng nào có thể nhận tin nhắn SMS đều có thể đăng nhập vào một tài khoản bằng số điện thoại của thiết bị.

Nếu sử dụng phương thức đăng nhập dựa trên số điện thoại trong ứng dụng, bạn nên cung cấp phương thức này cùng với các phương thức đăng nhập an toàn hơn và thông báo cho người dùng về sự đánh đổi về bảo mật khi sử dụng phương thức đăng nhập bằng số điện thoại.

Bật tính năng Đăng nhập bằng số điện thoại cho dự án Firebase

Để đăng nhập người dùng bằng SMS, trước tiên, bạn phải bật phương thức đăng nhập bằng Số điện thoại cho dự án Firebase:

1. Trong bảng điều khiển Firebase, hãy mở mục Xác thực.
2. Trên trang Phương thức đăng nhập, hãy bật phương thức đăng nhập bằng Số điện thoại.

Bật tính năng xác minh ứng dụng

Để sử dụng tính năng xác thực số điện thoại, Firebase phải có thể xác minh rằng các yêu cầu đăng nhập bằng số điện thoại đến từ ứng dụng của bạn. Firebase Authentication có hai cách để thực hiện việc này:

• Thông báo APN không âm thanh: Khi bạn đăng nhập người dùng bằng số điện thoại của họ lần đầu tiên trên một thiết bị, Firebase Authentication sẽ gửi một mã thông báo đến thiết bị đó bằng thông báo đẩy không âm thanh. Nếu ứng dụng của bạn nhận được thông báo từ Firebase thành công, thì quy trình đăng nhập bằng số điện thoại có thể tiếp tục.

  Đối với iOS 8.0 trở lên, thông báo không âm thanh không yêu cầu người dùng đồng ý một cách rõ ràng. Do đó, thông báo này không bị ảnh hưởng khi người dùng từ chối nhận thông báo APN trong ứng dụng. Vì vậy, ứng dụng không cần yêu cầu người dùng cấp quyền nhận thông báo đẩy khi triển khai tính năng xác thực số điện thoại Firebase.

• Xác minh reCAPTCHA: Trong trường hợp không thể gửi hoặc nhận thông báo đẩy không âm thanh, chẳng hạn như khi người dùng tắt tính năng làm mới trong nền cho ứng dụng của bạn hoặc khi kiểm thử ứng dụng trên trình mô phỏng iOS, Firebase Authentication sẽ sử dụng quy trình xác minh reCAPTCHA để hoàn tất quy trình đăng nhập bằng điện thoại. Người dùng thường có thể hoàn tất thử thách reCAPTCHA mà không cần giải quyết bất kỳ vấn đề nào.
Quy trình xác thực qua điện thoại trên iOS sử dụng thông báo đẩy không âm thanh để xác minh ứng dụng khách. Nếu không thành công, hệ thống sẽ quay lại reCAPTCHA. Quy trình reCAPTCHA này yêu cầu Khoá API của bạn không bị hạn chế hoặc có trong danh sách cho phép cho "${PROJECT_NAME}.firebaseapp.com".

Khi thông báo đẩy không âm thanh được định cấu hình đúng cách, chỉ một tỷ lệ rất nhỏ người dùng sẽ trải nghiệm quy trình reCAPTCHA. Tuy nhiên, bạn nên đảm bảo rằng tính năng đăng nhập bằng số điện thoại hoạt động chính xác, cho dù có thông báo đẩy không âm thanh hay không.

Để đảm bảo cả hai trường hợp đều hoạt động chính xác, hãy kiểm thử ứng dụng của bạn trên một thiết bị thực có bật và tắt tính năng làm mới ứng dụng trong nền. Khi tính năng làm mới ứng dụng ở chế độ nền bị tắt, bạn sẽ có thể đăng nhập thành công sau khi hoàn tất thử thách reCAPTCHA. Bạn cũng có thể kiểm thử quy trình reCAPTCHA bằng cách chạy ứng dụng trên trình mô phỏng iOS. Trình mô phỏng này luôn sử dụng quy trình reCAPTCHA.

Bắt đầu nhận thông báo không có âm thanh

Cách bật thông báo APN để sử dụng với Firebase Authentication:

1. Trong Xcode, hãy bật thông báo đẩy cho dự án của bạn.

2. Tải khoá xác thực APN lên Firebase. Nếu bạn chưa có khoá xác thực APNs, hãy nhớ tạo khoá trong Apple Developer Member Center.

   1. Bên trong dự án của bạn trong bảng điều khiển Firebase, hãy chọn biểu tượng bánh răng, chọn Project Settings (Cài đặt dự án), sau đó chọn thẻ Cloud Messaging (Thông báo trên đám mây).

   2. Trong phần Khoá xác thực APN trong mục Cấu hình ứng dụng iOS, hãy nhấp vào nút Tải lên.

   3. Duyệt đến vị trí bạn đã lưu khoá, chọn khoá đó rồi nhấp vào Mở. Thêm mã khoá cho khoá (có trong Trung tâm thành viên dành cho nhà phát triển của Apple) rồi nhấp vào Tải lên.

   Nếu đã có chứng chỉ APNs, bạn có thể tải chứng chỉ đó lên.

3. Trong Xcode, hãy bật tính năng Chế độ nền cho dự án của bạn, sau đó chọn hộp đánh dấu cho chế độ Tìm nạp ở chế độ nền và Thông báo từ xa.

Thiết lập tính năng xác minh bằng reCAPTCHA

Cách bật SDK Firebase để sử dụng tính năng xác minh reCAPTCHA:

1. Thêm giao thức URL tuỳ chỉnh vào dự án Xcode:
   1. Mở cấu hình dự án: nhấp đúp vào tên dự án trong chế độ xem dạng cây ở bên trái. Chọn ứng dụng của bạn trong mục TARGETS (MỤC TIÊU), sau đó chọn thẻ Info (Thông tin) rồi mở rộng mục URL Types (Loại URL).
   2. Nhấp vào nút + rồi thêm Mã ứng dụng đã mã hoá làm giao thức URL. Bạn có thể tìm thấy Mã ứng dụng đã mã hoá trên trang Cài đặt chung của bảng điều khiển Firebase, trong phần dành cho ứng dụng iOS. Hãy để trống các trường khác.

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

      
2. Không bắt buộc: Nếu bạn muốn tuỳ chỉnh cách ứng dụng hiển thị SFSafariViewController khi hiển thị reCAPTCHA cho người dùng, hãy tạo một lớp tuỳ chỉnh tuân thủ giao thức AuthUIDelegate và truyền lớp đó đến verifyPhoneNumber(_:uiDelegate:completion:).

Gửi mã xác minh đến điện thoại của người dùng

Để bắt đầu đăng nhập bằng số điện thoại, hãy hiển thị cho người dùng một giao diện nhắc họ cung cấp số điện thoại, sau đó gọi verifyPhoneNumber(_:uiDelegate:completion:) để yêu cầu Firebase gửi mã xác thực đến điện thoại của người dùng qua SMS:

1. Lấy số điện thoại của người dùng.

   Các yêu cầu pháp lý khác nhau tuỳ theo quốc gia, nhưng theo phương pháp hay nhất và để đặt ra kỳ vọng cho người dùng, bạn nên thông báo cho họ rằng nếu sử dụng tính năng đăng nhập bằng điện thoại, họ có thể nhận được tin nhắn SMS để xác minh và sẽ phải trả mức phí tiêu chuẩn.

2. Gọi verifyPhoneNumber(_:uiDelegate:completion:), truyền vào số điện thoại của người dùng.
   SwiftObjective-C
   PhoneAuthProvider.provider()
     .verifyPhoneNumber(phoneNumber, uiDelegate: nil) { verificationID, error in
         if let error = error {
           self.showMessagePrompt(error.localizedDescription)
           return
         }
         // Sign in using the verificationID and the code sent to the user
         // ...
     }

   [[FIRPhoneAuthProvider provider] verifyPhoneNumber:userInput
                                           UIDelegate:nil
                                           completion:^(NSString * _Nullable verificationID, NSError * _Nullable error) {
     if (error) {
       [self showMessagePrompt:error.localizedDescription];
       return;
     }
     // Sign in using the verificationID and the code sent to the user
     // ...
   }];

   Lưu ý: Tuỳ thuộc vào gói thanh toán, bạn có thể bị giới hạn số lượng tin nhắn SMS gửi được mỗi ngày. Xem Giới hạn của Firebase Authentication.

   Phương thức verifyPhoneNumber có thể truy cập lại: nếu bạn gọi phương thức này nhiều lần, chẳng hạn như trong phương thức onAppear của thành phần hiển thị, thì phương thức verifyPhoneNumber sẽ không gửi tin nhắn SMS thứ hai trừ phi yêu cầu ban đầu đã hết thời gian chờ.

   Khi bạn gọi verifyPhoneNumber(_:uiDelegate:completion:), Firebase sẽ gửi một thông báo đẩy thầm đến ứng dụng của bạn hoặc đưa ra một thử thách reCAPTCHA cho người dùng. Sau khi ứng dụng của bạn nhận được thông báo hoặc người dùng hoàn tất thử thách reCAPTCHA, Firebase sẽ gửi một tin nhắn SMS chứa mã xác thực đến số điện thoại đã chỉ định và chuyển mã xác minh đến hàm hoàn tất. Bạn sẽ cần cả mã xác minh và mã nhận dạng xác minh để đăng nhập cho người dùng.

   Bạn cũng có thể bản địa hoá tin nhắn SMS do Firebase gửi bằng cách chỉ định ngôn ngữ xác thực thông qua thuộc tính languageCode trên thực thể Auth.

   SwiftObjective-C
    // Change language code to french.
    Auth.auth().languageCode = "fr";

    // Change language code to french.
    [FIRAuth auth].languageCode = @"fr";

3. Lưu mã xác minh và khôi phục mã đó khi ứng dụng của bạn tải. Bằng cách này, bạn có thể đảm bảo rằng bạn vẫn có mã xác minh hợp lệ nếu ứng dụng của bạn bị chấm dứt trước khi người dùng hoàn tất quy trình đăng nhập (ví dụ: trong khi chuyển sang ứng dụng SMS).

   Bạn có thể lưu trữ mã xác minh theo bất kỳ cách nào bạn muốn. Một cách đơn giản là lưu mã xác minh bằng đối tượng NSUserDefaults:

   SwiftObjective-C
   UserDefaults.standard.set(verificationID, forKey: "authVerificationID")

   NSUserDefaults *defaults = [NSUserDefaults standardUserDefaults];
   [defaults setObject:verificationID forKey:@"authVerificationID"];

   Sau đó, bạn có thể khôi phục giá trị đã lưu:

   SwiftObjective-C
   let verificationID = UserDefaults.standard.string(forKey: "authVerificationID")

   NSString *verificationID = [defaults stringForKey:@"authVerificationID"];

Nếu lệnh gọi đến verifyPhoneNumber(_:uiDelegate:completion:) thành công, bạn có thể nhắc người dùng nhập mã xác minh khi họ nhận được mã đó trong tin nhắn SMS.

Để ngăn chặn hành vi sai trái, Firebase thực thi giới hạn về số lượng tin nhắn SMS có thể gửi đến một số điện thoại trong một khoảng thời gian. Nếu bạn vượt quá hạn mức này, các yêu cầu xác minh số điện thoại có thể bị điều tiết. Nếu bạn gặp vấn đề này trong quá trình phát triển, hãy sử dụng một số điện thoại khác để kiểm thử hoặc thử lại yêu cầu sau.

Đăng nhập cho người dùng bằng mã xác minh

Sau khi người dùng cung cấp cho ứng dụng của bạn mã xác minh từ tin nhắn SMS, hãy đăng nhập người dùng bằng cách tạo đối tượng FIRPhoneAuthCredential từ mã xác minh và mã xác minh, sau đó truyền đối tượng đó đến signInWithCredential:completion:.

1. Nhận mã xác minh từ người dùng.
2. Tạo đối tượng FIRPhoneAuthCredential từ mã xác minh và mã xác minh.
   SwiftObjective-C
   let credential = PhoneAuthProvider.provider().credential(
     withVerificationID: verificationID,
     verificationCode: verificationCode
   )

   FIRAuthCredential *credential = [[FIRPhoneAuthProvider provider]
       credentialWithVerificationID:verificationID
                   verificationCode:userInput];

3. Đăng nhập người dùng bằng đối tượng FIRPhoneAuthCredential:
   SwiftObjective-C
   Auth.auth().signIn(with: credential) { authResult, error in
       if let error = error {
         let authError = error as NSError
         if isMFAEnabled, authError.code == AuthErrorCode.secondFactorRequired.rawValue {
           // The user is a multi-factor user. Second factor challenge is required.
           let resolver = authError
             .userInfo[AuthErrorUserInfoMultiFactorResolverKey] as! MultiFactorResolver
           var displayNameString = ""
           for tmpFactorInfo in resolver.hints {
             displayNameString += tmpFactorInfo.displayName ?? ""
             displayNameString += " "
           }
           self.showTextInputPrompt(
             withMessage: "Select factor to sign in\n\(displayNameString)",
             completionBlock: { userPressedOK, displayName in
               var selectedHint: PhoneMultiFactorInfo?
               for tmpFactorInfo in resolver.hints {
                 if displayName == tmpFactorInfo.displayName {
                   selectedHint = tmpFactorInfo as? PhoneMultiFactorInfo
                 }
               }
               PhoneAuthProvider.provider()
                 .verifyPhoneNumber(with: selectedHint!, uiDelegate: nil,
                                    multiFactorSession: resolver
                                      .session) { verificationID, error in
                   if error != nil {
                     print(
                       "Multi factor start sign in failed. Error: \(error.debugDescription)"
                     )
                   } else {
                     self.showTextInputPrompt(
                       withMessage: "Verification code for \(selectedHint?.displayName ?? "")",
                       completionBlock: { userPressedOK, verificationCode in
                         let credential: PhoneAuthCredential? = PhoneAuthProvider.provider()
                           .credential(withVerificationID: verificationID!,
                                       verificationCode: verificationCode!)
                         let assertion: MultiFactorAssertion? = PhoneMultiFactorGenerator
                           .assertion(with: credential!)
                         resolver.resolveSignIn(with: assertion!) { authResult, error in
                           if error != nil {
                             print(
                               "Multi factor finanlize sign in failed. Error: \(error.debugDescription)"
                             )
                           } else {
                             self.navigationController?.popViewController(animated: true)
                           }
                         }
                       }
                     )
                   }
                 }
             }
           )
         } else {
           self.showMessagePrompt(error.localizedDescription)
           return
         }
         // ...
         return
       }
       // 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;
     // ...
   }];

Kiểm thử bằng số điện thoại hư cấu

Bạn có thể thiết lập số điện thoại hư cấu để phát triển thông qua bảng điều khiển Firebase. Việc kiểm thử bằng số điện thoại giả mang lại các lợi ích sau:

• Kiểm thử tính năng xác thực số điện thoại mà không làm hao tổn hạn mức sử dụng.
• Kiểm thử tính năng xác thực số điện thoại mà không cần gửi tin nhắn SMS thực tế.
• Chạy các bài kiểm thử liên tiếp bằng cùng một số điện thoại mà không bị điều tiết. Điều này giúp giảm thiểu nguy cơ bị từ chối trong quá trình xem xét của Cửa hàng ứng dụng nếu người đánh giá sử dụng cùng một số điện thoại để kiểm thử.
• Kiểm thử dễ dàng trong môi trường phát triển mà không cần thêm bất kỳ nỗ lực nào, chẳng hạn như khả năng phát triển trong trình mô phỏng iOS hoặc trình mô phỏng Android mà không cần Dịch vụ Google Play.
• Viết mã kiểm thử tích hợp mà không bị chặn bởi các quy trình kiểm tra bảo mật thường áp dụng cho số điện thoại thực trong môi trường sản xuất.

Số điện thoại hư cấu phải đáp ứng các yêu cầu sau:

1. Đảm bảo rằng bạn sử dụng số điện thoại thực sự là hư cấu và chưa tồn tại. Firebase Authentication không cho phép bạn đặt số điện thoại hiện có mà người dùng thực sử dụng làm số điện thoại thử nghiệm. Bạn có thể sử dụng số điện thoại có tiền tố 555 làm số điện thoại thử nghiệm ở Hoa Kỳ, ví dụ: [phone]
2. Số điện thoại phải được định dạng chính xác về độ dài và các quy tắc ràng buộc khác. Các số điện thoại này vẫn sẽ trải qua quy trình xác thực giống như số điện thoại của người dùng thực.
3. Bạn có thể thêm tối đa 10 số điện thoại để phát triển.
4. Sử dụng số điện thoại/mã thử nghiệm khó đoán và thường xuyên thay đổi.

Tạo số điện thoại và mã xác minh giả

1. Trong bảng điều khiển Firebase, hãy mở mục Xác thực.
2. Trong thẻ Phương thức đăng nhập, hãy bật Nhà cung cấp dịch vụ điện thoại nếu bạn chưa bật.
3. Mở trình đơn dạng xếp Số điện thoại để kiểm thử.
4. Cung cấp số điện thoại bạn muốn kiểm tra, ví dụ: [phone].
5. Cung cấp mã xác minh gồm 6 chữ số cho số điện thoại cụ thể đó, ví dụ: 654321.
6. Thêm số điện thoại. Nếu cần, bạn có thể xoá số điện thoại và mã số điện thoại bằng cách di chuột qua hàng tương ứng rồi nhấp vào biểu tượng thùng rác.

Kiểm thử thủ công

Bạn có thể bắt đầu sử dụng một số điện thoại hư cấu trong ứng dụng của mình. Điều này cho phép bạn thực hiện kiểm thử thủ công trong các giai đoạn phát triển mà không gặp phải vấn đề về hạn mức hoặc bị điều tiết. Bạn cũng có thể kiểm thử trực tiếp từ trình mô phỏng iOS hoặc trình mô phỏng Android mà không cần cài đặt Dịch vụ Google Play.

Khi bạn cung cấp số điện thoại hư cấu và gửi mã xác minh, hệ thống sẽ không gửi tin nhắn SMS thực tế. Thay vào đó, bạn cần cung cấp mã xác minh đã định cấu hình trước đó để hoàn tất quy trình đăng nhập.

Khi hoàn tất quy trình đăng nhập, hệ thống sẽ tạo một người dùng Firebase bằng số điện thoại đó. Người dùng này có hành vi và thuộc tính giống như người dùng số điện thoại thực và có thể truy cập vào Realtime Database/Cloud Firestore cũng như các dịch vụ khác theo cách tương tự. Mã thông báo nhận dạng được tạo trong quá trình này có chữ ký giống với người dùng số điện thoại thực.

Vì mã thông báo nhận dạng cho số điện thoại hư cấu có cùng chữ ký với người dùng số điện thoại thực, nên điều quan trọng là bạn phải lưu trữ các số này một cách an toàn và liên tục tái chế các số đó.

Một cách khác là thiết lập vai trò thử nghiệm thông qua thông báo xác nhận quyền sở hữu tuỳ chỉnh cho những người dùng này để phân biệt họ là người dùng giả mạo nếu bạn muốn hạn chế thêm quyền truy cập.

Kiểm thử tích hợp

Ngoài việc kiểm thử thủ công, Firebase Authentication còn cung cấp các API để giúp viết mã kiểm thử tích hợp cho việc kiểm thử xác thực qua điện thoại. Các API này tắt tính năng xác minh ứng dụng bằng cách tắt yêu cầu reCAPTCHA trên web và thông báo đẩy thầm trên iOS. Điều này giúp bạn có thể kiểm thử tự động trong các luồng này và dễ triển khai hơn. Ngoài ra, các API này còn giúp bạn có thể kiểm thử quy trình xác minh tức thì trên Android.

Đảm bảo rằng bạn không tắt tính năng xác minh ứng dụng cho các ứng dụng phát hành công khai và không có số điện thoại hư cấu nào được mã hoá cứng trong ứng dụng phát hành công khai.

Trên iOS, bạn phải đặt chế độ cài đặt appVerificationDisabledForTesting thành TRUE trước khi gọi verifyPhoneNumber. Quá trình này được xử lý mà không yêu cầu mã thông báo APN nào hoặc gửi thông báo đẩy im lặng ở chế độ nền, giúp bạn dễ dàng kiểm thử trong trình mô phỏng hơn. Thao tác này cũng sẽ tắt quy trình dự phòng reCAPTCHA.

Xin lưu ý rằng khi tính năng xác minh ứng dụng bị tắt, bạn sẽ không thể hoàn tất quy trình đăng nhập nếu sử dụng số điện thoại không phải là số điện thoại giả. Bạn chỉ có thể sử dụng số điện thoại hư cấu với API này.

SwiftObjective-C

let phoneNumber = "[phone]"

// This test verification code is specified for the given test phone number in the developer console.
let testVerificationCode = "123456"

Auth.auth().settings.isAppVerificationDisabledForTesting = TRUE
PhoneAuthProvider.provider().verifyPhoneNumber(phoneNumber, uiDelegate:nil) {
                                                            verificationID, error in
    if (error) {
      // Handles error
      self.handleError(error)
      return
    }
    let credential = PhoneAuthProvider.provider().credential(withVerificationID: verificationID ?? "",
                                                               verificationCode: testVerificationCode)
    Auth.auth().signInAndRetrieveData(with: credential) { authData, error in
      if (error) {
        // Handles error
        self.handleError(error)
        return
      }
      _user = authData.user
    }];
}];

NSString *phoneNumber = @"[phone]";

// This test verification code is specified for the given test phone number in the developer console.
NSString *testVerificationCode = @"123456";

[FIRAuth auth].settings.appVerificationDisabledForTesting = YES;
[[FIRPhoneAuthProvider provider] verifyPhoneNumber:phoneNumber
                                        completion:^(NSString *_Nullable verificationID,
                                                     NSError *_Nullable error) {
    if (error) {
      // Handles error
      [self handleError:error];
      return;
    }
    FIRAuthCredential *credential =
        [FIRPhoneAuthProvider credentialWithVerificationID:verificationID
                                          verificationCode:testVerificationCode];
    [FIRAuth auth] signInWithAndRetrieveDataWithCredential:credential
                                                completion:^(FIRUser *_Nullable user,
                                                             NSError *_Nullable error) {
      if (error) {
        // Handles error
        [self handleError:error];
        return;
      }
      _user = user;
    }];
}];

Phụ lục: Sử dụng tính năng đăng nhập bằng điện thoại mà không cần hoán đổi

Firebase Authentication sử dụng tính năng hoán đổi phương thức để tự động lấy mã thông báo APN của ứng dụng, để xử lý thông báo đẩy không âm thanh mà Firebase gửi đến ứng dụng và tự động chặn lệnh chuyển hướng giao thức tuỳ chỉnh từ trang xác minh reCAPTCHA trong quá trình xác minh.

Nếu không muốn sử dụng tính năng hoán đổi, bạn có thể tắt tính năng này bằng cách thêm cờ FirebaseAppDelegateProxyEnabled vào tệp Info.plist của ứng dụng và đặt cờ này thành NO. Xin lưu ý rằng việc đặt cờ này thành NO cũng tắt tính năng hoán đổi cho các sản phẩm Firebase khác, bao gồm cả Firebase Cloud Messaging.

Nếu tắt tính năng hoán đổi, bạn phải truyền mã thông báo thiết bị APN, thông báo đẩy và URL chuyển hướng theo giao thức tuỳ chỉnh đến Firebase Authentication một cách rõ ràng.

Nếu đang xây dựng ứng dụng SwiftUI, bạn cũng nên truyền mã thông báo thiết bị APN, thông báo đẩy và URL chuyển hướng giao thức tuỳ chỉnh đến Firebase Authentication một cách rõ ràng.

Để lấy mã thông báo thiết bị APNs, hãy triển khai phương thức application(_:didRegisterForRemoteNotificationsWithDeviceToken:) và trong đó, truyền mã thông báo thiết bị đến phương thức setAPNSToken(_:type:) của Auth.

Lưu ý: Ứng dụng SwiftUI nên sử dụng trình bao bọc thuộc tính UIApplicationDelegateAdaptor hoặc NSApplicationDelegateAdaptor để cung cấp một loại tương ứng với giao thức uỷ quyền ứng dụng thích hợp.

SwiftObjective-C

func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
  // Pass device token to auth
  Auth.auth().setAPNSToken(deviceToken, type: .unknown)

  // Further handling of the device token if needed by the app
  // ...
}

- (void)application:(UIApplication *)application
    didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
  // Pass device token to auth.
  [[FIRAuth auth] setAPNSToken:deviceToken type:FIRAuthAPNSTokenTypeProd];
  // Further handling of the device token if needed by the app.
}

Để xử lý thông báo đẩy, trong phương thức application(_:didReceiveRemoteNotification:fetchCompletionHandler:):, hãy kiểm tra các thông báo liên quan đến xác thực Firebase bằng cách gọi phương thức canHandleNotification(_:) của Auth.

SwiftObjective-C

func application(_ application: UIApplication,
    didReceiveRemoteNotification notification: [AnyHashable : Any],
    fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {
  if Auth.auth().canHandleNotification(notification) {
    completionHandler(.noData)
    return
  }
  // This notification is not auth related; it should be handled separately.
}

- (void)application:(UIApplication *)application
    didReceiveRemoteNotification:(NSDictionary *)notification
          fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler {
  // Pass notification to auth and check if they can handle it.
  if ([[FIRAuth auth] canHandleNotification:notification]) {
    completionHandler(UIBackgroundFetchResultNoData);
    return;
  }
  // This notification is not auth related; it should be handled separately.
}

Để xử lý URL chuyển hướng theo lược đồ tuỳ chỉnh, hãy triển khai phương thức application(_:open:options:) và trong đó, truyền URL đến phương thức canHandleURL(_:) của Auth.

SwiftObjective-C

func application(_ application: UIApplication, open url: URL,
    options: [UIApplicationOpenURLOptionsKey : Any]) -> Bool {
  if Auth.auth().canHandle(url) {
    return true
  }
  // URL not auth related; it should be handled separately.
}

- (BOOL)application:(UIApplication *)app
            openURL:(NSURL *)url
            options:(NSDictionary<UIApplicationOpenURLOptionsKey, id> *)options {
  if ([[FIRAuth auth] canHandleURL:url]) {
    return YES;
  }
  // URL not auth related; it should be handled separately.
}

Nếu bạn đang sử dụng SwiftUI hoặc UISceneDelegate, để xử lý URL chuyển hướng, hãy triển khai phương thức scene(_:openURLContexts:) và trong đó, truyền URL đến phương thức canHandleURL(_:) của Auth.

SwiftObjective-C

func scene(_ scene: UIScene, openURLContexts URLContexts: Set&ltUIOpenURLContext&gt) {
  for urlContext in URLContexts {
      let url = urlContext.url
      _ = Auth.auth().canHandle(url)
  }
  // URL not auth related; it should be handled separately.
}

- (void)scene:(UIScene *)scene openURLContexts:(NSSet&ltUIOpenURLContext *&gt *)URLContexts {
  for (UIOpenURLContext *urlContext in URLContexts) {
    [FIRAuth.auth canHandleURL:urlContext.url];
    // URL not auth related; it should be handled separately.
  }
}

Các bước tiếp theo

Sau khi người dùng đăng nhập lần đầu, 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 về 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ữ trong dự án Firebase và có thể được dùng để xác định người dùng trên mọi ứng dụng trong dự án, bất kể người dùng đăng nhập như thế nào.

• Trong ứng dụng, 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 phần Quản lý người dùng.

• Trong Quy tắc bảo mật Firebase Realtime Database và Cloud Storage, 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 và sử dụng mã nhận dạng đó để kiểm soát 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 bạn bằng nhiều trình cung cấp dịch vụ xác thực bằng cách liên kết thông tin xác thực của trình cung cấp dịch vụ xác thực với một tài khoản người dùng hiện có.

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

SwiftObjective-C

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;
}

Bạn cũng nên thêm mã xử lý lỗi cho toàn bộ lỗi xác thực. Xem phần Xử lý lỗi.