在 Apple 平台上使用電話號碼驗證 Firebase

您可以透過 Firebase Authentication 將簡訊傳送至使用者的手機，讓使用者登入。使用者透過簡訊中的一次性代碼登入。

在應用程式中新增電話號碼登入功能的簡單方法，就是使用 FirebaseUI，其中包含置入式登入小工具，可實作電話號碼登入、密碼登入和聯合登入的登入流程。本文說明如何使用 Firebase SDK 導入電話號碼登入流程。

Google 會傳送並儲存使用者提供的電話號碼，以改善 Google 服務 (包括但不限於 Firebase) 的垃圾內容和濫用行為防範機制。開發人員應確保已取得適當的使用者同意聲明，再使用Firebase Authentication電話號碼登入服務。

事前準備

1. 如果尚未將應用程式連結至 Firebase 專案，請從 Firebase 控制台進行連結。

2. 使用 Swift Package Manager 安裝及管理 Firebase 依附元件。

   請參閱安裝指南，瞭解將 Firebase SDK 新增至 Apple 專案的各種方式，包括直接匯入架構和使用 CocoaPods。
   1. 在 Xcode 中保持開啟應用程式專案，然後依序點選「File」(檔案) 和「Add Packages」(新增 Package)。
   2. 系統提示時，請新增 Firebase Apple 平台 SDK 存放區：

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

   注意：新專案應使用預設 (最新) 的 SDK 版本，但您也可以視需要選擇舊版。
   3. 選擇 Firebase Authentication 程式庫。
   4. 將 -ObjC 標記新增至目標建構設定的「Other Linker Flags」部分。
   5. 完成後，Xcode 會自動開始在背景中解析並下載依附元件。

安全疑慮

僅使用電話號碼驗證雖然方便，但安全性不如其他可用方法，因為電話號碼很容易在使用者之間轉移。此外，如果裝置有多個使用者設定檔，任何可接收簡訊的使用者都能使用裝置的電話號碼登入帳戶。

如果應用程式採用電話號碼登入方式，請一併提供更安全的登入方式，並告知使用者使用電話號碼登入的安全性考量。

為 Firebase 專案啟用電話號碼登入功能

如要透過簡訊登入使用者，請先為 Firebase 專案啟用電話號碼登入方法：

1. 在 Firebase 控制台中，開啟「驗證」部分。
2. 在「登入方式」頁面中，啟用「電話號碼」登入方式。
3. 選用：在「設定」頁面中，針對要允許或拒絕傳送簡訊的區域設定政策。設定簡訊區域政策有助於保護應用程式，防範簡訊濫用行為。

啟用應用程式驗證

如要使用電話號碼驗證功能，Firebase 必須能夠驗證電話號碼登入要求來自您的應用程式。Firebase Authentication 可透過兩種方式達成此目的：

• 無聲 APNs 通知：當您在裝置上首次使用電話號碼登入使用者時，Firebase Authentication 會透過無聲推播通知將權杖傳送至裝置。如果應用程式成功收到 Firebase 的通知，即可繼續進行電話號碼登入程序。

  對於 iOS 8.0 以上版本，無聲通知不需要使用者明確同意，因此使用者在應用程式中拒絕接收 APNs 通知，不會影響無聲通知。因此，實作 Firebase 電話號碼驗證時，應用程式不需要要求使用者授權接收推播通知。

• reCAPTCHA 驗證：如果無法傳送或接收無聲推播通知 (例如使用者已停用應用程式的背景重新整理功能，或是在 iOS 模擬器上測試應用程式)，Firebase Authentication 會使用 reCAPTCHA 驗證完成手機登入流程。使用者通常不必回答任何問題，就能完成 reCAPTCHA 驗證。
iOS 上的電話驗證會使用無聲推播通知進行用戶端應用程式驗證。如果失敗，系統會改用 reCAPTCHA。如要使用這個 reCAPTCHA 流程，您的 API 金鑰必須不受限制，或是已加入「${PROJECT_NAME}.firebaseapp.com」的允許清單。

如果無聲推播通知設定正確，只有極少數使用者會遇到 reCAPTCHA 流程。不過，無論是否提供無聲推播通知，您都應確保電話號碼登入功能正常運作。

為確保這兩種情況都能正常運作，請在實體裝置上測試應用程式，並分別啟用和停用背景應用程式重新整理功能。停用「背景 App 重新整理」後，完成 reCAPTCHA 驗證問題後應該就能順利登入。您也可以在 iOS 模擬器上執行應用程式，測試 reCAPTCHA 流程，模擬器一律會使用 reCAPTCHA 流程。

開始接收低擾式通知

如要啟用 APNs 通知，以便搭配 Firebase Authentication 使用，請按照下列步驟操作：

1. 在 Xcode 中，為專案 啟用推播通知。

2. 將 APNs 驗證金鑰上傳至 Firebase。 如果沒有 APNs 驗證金鑰，請務必在 Apple 開發人員會員中心建立。

   1. 在 Firebase 控制台的專案中，依序選取齒輪圖示、「專案設定」和「Cloud Messaging」分頁標籤。

   2. 在「iOS 應用程式設定」下方的「APN 驗證金鑰」中， 按一下「上傳」按鈕，上傳開發或正式版驗證金鑰，或同時上傳兩者。至少必須有一個。

   3. 瀏覽至您儲存金鑰的位置，選取金鑰，然後按一下「開啟」。新增金鑰的 ID (可在 Apple Developer Member Center 中取得)，然後按一下「上傳」。

   如果您已有 APN 憑證，可以改為上傳憑證。

3. 在 Xcode 中， 為專案啟用「Background Modes」功能，然後勾選「Background fetch」和「Remote notifications」模式的核取方塊。

設定 reCAPTCHA 驗證

如要啟用 Firebase SDK 的 reCAPTCHA 驗證功能，請按照下列步驟操作：

1. 在 Xcode 專案中新增自訂網址配置：
   1. 開啟專案設定：在左側樹狀檢視中按兩下專案名稱。在「目標」部分選取應用程式，然後選取「資訊」分頁標籤，並展開「網址類型」部分。
   2. 按一下「+」按鈕，然後將已編碼的應用程式 ID 新增為網址配置。您可以在 Firebase 控制台的「一般設定」頁面，找到 iOS 應用程式區段中的編碼應用程式 ID。其他欄位請留空。

      完成後，您的設定應如下所示 (但會使用應用程式專屬值)：

      
2. 選用：如要在向使用者顯示 reCAPTCHA 時自訂應用程式呈現 SFSafariViewController 的方式，請建立符合 AuthUIDelegate 協定的自訂類別，並傳遞至 verifyPhoneNumber(_:uiDelegate:completion:)。

將驗證碼傳送至使用者的手機

如要啟動電話號碼登入程序，請向使用者顯示介面，提示他們提供電話號碼，然後呼叫 verifyPhoneNumber(_:uiDelegate:completion:)，要求 Firebase 透過簡訊將驗證碼傳送至使用者的手機：

1. 取得使用者的電話號碼。

   法律規定因國家/地區而異，但為了提供最佳做法並讓使用者瞭解相關資訊，請告知他們如果使用手機登入，可能會收到驗證簡訊，且須支付一般簡訊費用。

2. 呼叫 verifyPhoneNumber(_:uiDelegate:completion:)，並將使用者的電話號碼傳遞給該函式。

   Swift

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

   Objective-C

   [[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
     // ...
   }];

   注意：視您的帳單方案而定，您可能會有每日傳送簡訊配額限制。請參閱Firebase Authentication限制。

   verifyPhoneNumber 方法是可重入的：如果您多次呼叫此方法 (例如在檢視區塊的 onAppear 方法中)，除非原始要求逾時，否則 verifyPhoneNumber 方法不會傳送第二則簡訊。

   當您呼叫 verifyPhoneNumber(_:uiDelegate:completion:) 時，Firebase 會傳送無聲推送通知給應用程式，或向使用者發出 reCAPTCHA 挑戰。應用程式收到通知或使用者完成 reCAPTCHA 挑戰後，Firebase 會將內含驗證碼的簡訊傳送至指定電話號碼，並將驗證 ID 傳遞至完成函式。您需要驗證碼和驗證 ID，才能登入使用者帳戶。

   您也可以透過 Auth 執行個體上的 languageCode 屬性指定驗證語言，讓 Firebase 傳送的簡訊採用當地語言。

   Swift

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

   Objective-C

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

3. 儲存驗證 ID，並在應用程式載入時還原。這麼做可確保在使用者完成登入流程前 (例如切換至簡訊應用程式時)，應用程式終止時仍有有效的驗證 ID。

   您可以透過任何方式保留驗證 ID。簡單的方法是使用 NSUserDefaults 物件儲存驗證 ID：

   Swift

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

   Objective-C

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

   接著，您可以還原儲存的值：

   Swift

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

   Objective-C

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

如果對 verifyPhoneNumber(_:uiDelegate:completion:) 的呼叫成功，您可以在使用者收到簡訊驗證碼時，提示他們輸入驗證碼。

為防止濫用行為，Firebase 會限制在一段時間內可傳送至單一電話號碼的簡訊數量。如果超過上限，系統可能會限制電話號碼驗證要求。如果在開發期間遇到這個問題，請使用其他電話號碼進行測試，或稍後再試一次。

使用驗證碼登入使用者

使用者在簡訊中提供驗證碼給應用程式後，請從驗證碼和驗證 ID 建立 FIRPhoneAuthCredential 物件，然後將該物件傳遞至 signInWithCredential:completion:，藉此登入使用者。

1. 向使用者索取驗證碼。
2. 根據驗證碼和驗證 ID 建立 FIRPhoneAuthCredential 物件。

   Swift

   let credential = PhoneAuthProvider.provider().credential(
     withVerificationID: verificationID,
     verificationCode: verificationCode
   )

   Objective-C

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

3. 使用 FIRPhoneAuthCredential 物件登入使用者：

   Swift

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

   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;
     // ...
   }];

使用虛構電話號碼進行測試

您可以透過 Firebase 控制台，設定開發用的虛構電話號碼。使用虛構電話號碼進行測試可享有以下好處：

• 測試電話號碼驗證，不會耗用使用配額。
• 測試電話號碼驗證，不必傳送實際的簡訊。
• 使用相同電話號碼連續進行測試，不會受到節流限制。如果審查人員在測試時使用相同的電話號碼，這樣就能盡量避免在應用程式商店審查程序中遭到拒絕。
• 在開發環境中輕鬆測試，不必費心進行額外作業，例如在 iOS 模擬器或 Android 模擬器中開發，不必使用 Google Play 服務。
• 編寫整合測試時，不會受到一般在正式環境中對實際電話號碼套用的安全檢查阻礙。

虛構電話號碼必須符合下列規定：

1. 請務必使用虛構的電話號碼，且該號碼不得已存在。 Firebase Authentication 不允許您將真實使用者使用的現有電話號碼設為測試號碼。 其中一個方法是使用以 555 為前置號碼的美國測試電話號碼，例如： [phone]
2. 電話號碼的長度和其他限制必須符合正確格式。系統仍會對這些號碼進行與一般使用者電話號碼相同的驗證。
3. 您最多可以新增 10 個開發用電話號碼。
4. 使用難以猜測的測試電話號碼/代碼，並經常變更。

建立虛構的電話號碼和驗證碼

1. 在 Firebase 控制台中，開啟「驗證」部分。
2. 在「登入方法」分頁中，啟用電話號碼供應商 (如果尚未啟用)。
3. 開啟「測試用電話號碼」手風琴選單。
4. 提供要測試的電話號碼，例如：[phone]。
5. 提供該號碼的 6 位數驗證碼，例如：654321。
6. 新增電話號碼。如有需要，只要將游標懸停在對應列上，然後點按垃圾桶圖示，即可刪除電話號碼和驗證碼。

手動測試

您可以在應用程式中直接使用虛構電話號碼。這樣一來，您就能在開發階段執行手動測試，而不必擔心配額問題或節流。您也可以直接從 iOS 模擬器或 Android Emulator 進行測試，不必安裝 Google Play 服務。

提供虛構電話號碼並傳送驗證碼時，系統不會傳送實際的簡訊。您必須提供先前設定的驗證碼，才能完成登入。

登入完成後，系統會使用該電話號碼建立 Firebase 使用者。使用者行為和屬性與實際電話號碼使用者相同，存取 Realtime Database/Cloud Firestore 和其他服務的方式也相同。在此程序中產生的 ID 權杖，與實際電話號碼使用者的簽章相同。

由於虛構電話號碼的 ID 權杖與真實電話號碼使用者的權杖具有相同簽章，因此請務必安全地儲存這些號碼，並持續回收這些號碼。

如要進一步限制存取權，也可以透過這些使用者的自訂聲明設定測試角色，將他們區分為虛假使用者。

整合測試

除了手動測試之外，Firebase Authentication 也提供 API，協助您為電話號碼驗證測試編寫整合測試。這些 API 會停用 reCAPTCHA 需求，以及 iOS 中的網頁和無聲推播通知，藉此停用應用程式驗證。因此您可以在這些流程中進行自動化測試，且實作起來也更輕鬆。此外，這些 API 也可協助您在 Android 上測試即時驗證流程。

請確認正式版應用程式未停用應用程式驗證，且正式版應用程式中沒有虛構的電話號碼。

在 iOS 上，必須先將 appVerificationDisabledForTesting 設定為 TRUE，才能呼叫 verifyPhoneNumber。這項程序不需要任何 APNs 權杖，也不會在背景傳送無聲推播通知，因此在模擬器中測試時會更加輕鬆。這麼做也會停用 reCAPTCHA 備用流程。

請注意，停用應用程式驗證後，使用非虛構電話號碼將無法完成登入。這個 API 只能使用虛構電話號碼。

Swift

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

Objective-C

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

附錄：使用手機登入，不必進行 Swizzling

Firebase Authentication 會使用方法調換，自動取得應用程式的 APNs 權杖、處理 Firebase 傳送至應用程式的無聲推播通知，以及在驗證期間自動攔截 reCAPTCHA 驗證頁面的自訂結構定義重新導向。

如不想使用 Swizzling，請在應用程式的 Info.plist 檔案中加入 FirebaseAppDelegateProxyEnabled 標記，並將其設為 NO，即可停用這項功能。請注意，將這個旗標設為 NO 也會停用其他 Firebase 產品 (包括 Firebase Cloud Messaging) 的交換。

如果停用交換，您必須明確將 APNs 裝置權杖、推播通知和自訂架構重新導向網址傳遞至 Firebase Authentication。

如果您要建構 SwiftUI 應用程式，也應明確將 APNs 裝置權杖、推播通知和自訂架構重新導向網址傳遞至 Firebase Authentication。

如要取得 APNs 裝置權杖，請實作 application(_:didRegisterForRemoteNotificationsWithDeviceToken:) 方法，並在該方法中將裝置權杖傳遞至 Auth 的 setAPNSToken(_:type:) 方法。

注意：SwiftUI 應用程式應使用 UIApplicationDelegateAdaptor 或 NSApplicationDelegateAdaptor 屬性包裝函式，提供與適當應用程式委派通訊協定對應的型別。

Swift

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

Objective-C

- (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.
}

如要處理推播通知，請在 application(_:didReceiveRemoteNotification:fetchCompletionHandler:): 方法中呼叫 Auth 的 canHandleNotification(_:) 方法，檢查 Firebase 驗證相關通知。

Swift

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

Objective-C

- (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.
}

如要處理自訂配置重新導向網址，請實作 application(_:open:options:) 方法，並在其中將網址傳遞至 Auth 的 canHandleURL(_:) 方法。

Swift

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

Objective-C

- (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.
}

如果您使用 SwiftUI 或 UISceneDelegate，請實作 scene(_:openURLContexts:) 方法來處理重新導向網址，並在這些方法中將網址傳遞至 Auth 的 canHandleURL(_:) 方法。

Swift

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

Objective-C

- (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.
  }
}

後續步驟

使用者首次登入後，系統會建立新的使用者帳戶，並連結至使用者登入時使用的憑證 (即使用者名稱和密碼、電話號碼或驗證供應商資訊)。這個新帳戶會儲存在 Firebase 專案中，可用於識別專案中每個應用程式的使用者，無論使用者登入方式為何。

• 在應用程式中，您可以從 User 物件取得使用者的基本個人資料資訊。請參閱「管理使用者」。

• 在 Firebase Realtime Database 和 Cloud Storage 安全規則中，您可以從 auth 變數取得已登入使用者的專屬使用者 ID， 並使用該 ID 控制使用者可存取的資料。

您可以將驗證供應商憑證連結至現有使用者帳戶，允許使用者透過多個驗證供應商登入應用程式。

如要登出使用者，請呼叫 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;
}

您也可以新增錯誤處理程式碼，處理各種驗證錯誤。請參閱「處理錯誤」。