使用電話號碼和 C++ 向 Firebase 進行身份驗證

您可以使用 Firebase 身份驗證通過向用戶的手機發送短信來登錄用戶。用戶使用 SMS 消息中包含的一次性代碼登錄。

本文檔介紹瞭如何使用 Firebase SDK 實現電話號碼登錄流程。

在你開始之前

  1. 將 Firebase 添加到您的 C++ 項目。
  2. 如果您尚未將您的應用程序連接到您的 Firebase 項目，請從Firebase 控制台執行此操作。
  3. 了解電話號碼登錄的平台要求：
    • 電話號碼登錄僅適用於移動平台。
    • 在 iOS 上，電話號碼登錄需要物理設備，無法在模擬器上使用。

安全問題

僅使用電話號碼進行身份驗證雖然方便，但不如其他可用方法安全，因為電話號碼的所有權可以在用戶之間輕鬆轉移。此外，在具有多個用戶配置文件的設備上，任何可以接收 SMS 消息的用戶都可以使用設備的電話號碼登錄帳戶。

如果您在您的應用中使用基於電話號碼的登錄，您應該將其與更安全的登錄方法一起提供，並告知用戶使用電話號碼登錄的安全權衡。

為您的 Firebase 項目啟用電話號碼登錄

要通過短信登錄用戶，您必須首先為您的 Firebase 項目啟用電話號碼登錄方法：

  1. 在Firebase 控制台中，打開身份驗證部分。
  2. 在登錄方法頁面上，啟用電話號碼登錄方法。

Firebase 的電話號碼登錄請求配額足夠高，大多數應用不會受到影響。但是，如果您需要使用電話身份驗證登錄大量用戶，則可能需要升級您的定價計劃。請參閱定價頁面。

開始接收 APNs 通知（Apple 平台）

要在 Apple 平台上使用電話號碼身份驗證，您的應用程序必須能夠從 Firebase 接收 APNs 通知。當您首次在設備上使用電話號碼登錄用戶時，Firebase 身份驗證會向設備發送靜默推送通知，以驗證電話號碼登錄請求是否來自您的應用。 （因此，不能在模擬器上使用電話號碼登錄。）

要啟用 APNs 通知以用於 Firebase 身份驗證：

  1. 在 Xcode 中，為您的項目啟用推送通知。

  2. 將您的 APNs 證書上傳到 Firebase。如果您還沒有 APNs 證書，請確保在Apple Developer Member Center中創建一個。

    1. 在 Firebase 控制台的項目內，選擇齒輪圖標，選擇Project Settings ，然後選擇Cloud Messaging選項卡。

    2. 為您的開發證書、生產證書或兩者選擇上傳證書按鈕。至少需要一個。

    3. 對於每個證書，選擇 .p12 文件，並提供密碼（如果有）。確保此證書的捆綁包 ID 與您的應用程序的捆綁包 ID 匹配。選擇保存。

發送驗證碼到用戶手機

要啟動電話號碼登錄，請向用戶顯示一個提示他們提供電話號碼的界面，然後調用PhoneAuthProvider::VerifyPhoneNumber以請求 Firebase 通過短信向用戶的電話發送身份驗證代碼：

  1. 獲取用戶的電話號碼。

    法律要求各不相同，但作為最佳實踐並為您的用戶設定期望，您應該告知他們，如果他們使用手機登錄，他們可能會收到一條短信進行驗證，並適用標準費率。

  2. 調用PhoneAuthProvider::VerifyPhoneNumber ，將用戶的電話號碼傳遞給它。 
    class PhoneListener : public PhoneAuthProvider::Listener {
 public:
  ~PhoneListener() override {}

  void OnVerificationCompleted(PhoneAuthCredential credential) override {
    // Auto-sms-retrieval or instant validation has succeeded (Android only).
    // No need for the user to input the verification code manually.
    // `credential` can be used instead of calling GetCredential().
  }

  void OnVerificationFailed(const std::string& error) override {
    // Verification code not sent.
  }

  void OnCodeSent(const std::string& verification_id,
                  const PhoneAuthProvider::ForceResendingToken&
                      force_resending_token) override {
    // Verification code successfully sent via SMS.
    // Show the Screen to enter the Code.
    // Developer may want to save that verification_id along with other app states in case
    // the app is terminated before the user gets the SMS verification code.
  }
};

PhoneListener phone_listener;
PhoneAuhtOptions options;
options.timeout_milliseconds = kAutoVerifyTimeOut;
options.phone_number = phone_number;
PhoneAuthProvider& phone_provider = PhoneAuthProvider::GetInstance(auth);
phone_provider->VerifyPhoneNumber(options, &phone_listener);
    當您調用PhoneAuthProvider::VerifyPhoneNumber時，Firebase，
    • （在 iOS 上）向您的應用發送靜默推送通知，
    • 向指定的電話號碼發送包含驗證碼的 SMS 消息，並將驗證 ID 傳遞給您的完成功能。您將需要驗證碼和驗證 ID 才能登錄用戶。

  3. 保存驗證 ID 並在您的應用加載時恢復它。通過這樣做，如果您的應用程序在用戶完成登錄流程之前終止（例如，切換到 SMS 應用程序時），您可以確保您仍然擁有有效的驗證 ID。

    您可以以任何方式保留驗證 ID。如果您使用跨平台 C++ 框架編寫，它應該提供應用程序終止和恢復的通知。在這些事件中，您可以分別保存和恢復驗證 ID。

如果調用VerifyPhoneNumber導致在您的偵聽器上調用OnCodeSent ，您可以提示用戶在 SMS 消息中收到驗證碼時鍵入驗證碼。

另一方面，如果對VerifyPhoneNumber調用導致OnVerificationCompleted ，則自動驗證已成功，您現在將擁有一個PhoneAuthCredential ，您可以按如下所述使用它。

使用驗證碼登錄用戶

在用戶向您的應用程序提供短信中的驗證碼後，通過從驗證碼和驗證 ID 創建一個PhoneAuthCredential對象並將該對像傳遞給Auth::SignInWithCredential來讓用戶登錄。

  1. 獲取用戶的驗證碼。
  2. 從驗證碼和驗證 ID 創建一個Credential對象。 
    PhoneAuthCredential credential = phone_auth_provider->GetCredential(
    verification_id_.c_str(), verification_code.c_str());
  3. 使用Credential對象登錄用戶： 
    Future<User> future = auth_->SignInWithCredential(credential);
future.OnCompletion(
    [](const Future<User*>& result, void*) {
      if (result.error() == kAuthErrorNone) {
        // Successful.
        // User is signed in.
        User user = *result.result();

        // This should display the phone number.
        printf("Phone number: %s", user.phone_number().c_str());

        // The phone number provider UID is the phone number itself.
        printf("Phone provider uid: %s", user.uid().c_str());

        // The phone number providerID is 'phone'
        printf("Phone provider ID: %s", user.provider_id().c_str());
      } else {
        // Error.
        printf("Sign in error: %s", result.error_message().c_str());
      }
    },
    nullptr);

下一步

用戶首次登錄後，將創建一個新的用戶帳戶並將其鏈接到用戶登錄所用的憑據，即用戶名和密碼、電話號碼或身份驗證提供商信息。這個新帳戶存儲為您的 Firebase 項目的一部分，可用於在項目中的每個應用程序中識別用戶，無論用戶如何登錄。

  • 在您的應用中，您可以從firebase::auth::User對象獲取用戶的基本個人資料信息：

    firebase::auth::User user = auth->current_user();
if (user.is_valid()) {
  std::string name = user.display_name();
  std::string email = user.email();
  std::string photo_url = user.photo_url();
  // The user's ID, unique to the Firebase project.
  // Do NOT use this value to authenticate with your backend server,
  // if you have one. Use firebase::auth::User::Token() instead.
  std::string uid = user.uid();
}

  • 在您的 Firebase Realtime Database 和 Cloud Storage Security Rules中，您可以從auth變量中獲取登錄用戶的唯一用戶 ID，並使用它來控制用戶可以訪問的數據。

您可以允許用戶使用多個身份驗證提供程序登錄您的應用程序，方法是將身份驗證提供程序憑據鏈接到現有用戶帳戶。

要註銷用戶，請調用SignOut() ：

auth->SignOut();