您可以使用 Firebase 身份驗證通過向用戶手機發送 SMS 消息來登錄用戶。用戶使用 SMS 消息中包含的一次性代碼登錄。
本文檔介紹如何使用 Firebase SDK 實現電話號碼登錄流程。
在你開始之前
- 將 Firebase 添加到您的 C++ 項目中。
- 如果您尚未將應用連接到 Firebase 項目,請從Firebase 控制台執行此操作。
在 Apple 平台上,請注意電話號碼登錄需要物理設備,並且無法在模擬器上運行。
安全問題
僅使用電話號碼的身份驗證雖然方便,但不如其他可用方法安全,因為電話號碼的擁有可以在用戶之間輕鬆轉移。此外,在具有多個用戶配置文件的設備上,任何可以接收 SMS 消息的用戶都可以使用設備的電話號碼登錄帳戶。
如果您在應用程序中使用基於電話號碼的登錄,則應將其與更安全的登錄方法一起提供,並告知用戶使用電話號碼登錄的安全權衡。
為您的 Firebase 項目啟用電話號碼登錄
要通過短信登錄用戶,您必須首先為您的 Firebase 項目啟用電話號碼登錄方法:
- 在Firebase 控制台中,打開身份驗證部分。
- 在登錄方式頁面,啟用電話號碼登錄方式。
Firebase 的電話號碼登錄請求配額足夠高,大多數應用不會受到影響。但是,如果您需要使用電話身份驗證登錄大量用戶,則可能需要升級您的定價計劃。請參閱定價頁面。
開始接收 APNs 通知(Apple 平台)
要在 Apple 平台上使用電話號碼身份驗證,您的應用必須能夠接收來自 Firebase 的 APNs 通知。當您首次在設備上使用用戶的電話號碼登錄用戶時,Firebase 身份驗證會向設備發送靜默推送通知,以驗證電話號碼登錄請求是否來自您的應用。 (因此,無法在模擬器上使用電話號碼登錄。)
要啟用 APNs 通知以用於 Firebase 身份驗證:
- 在 Xcode 中,為您的項目啟用推送通知。
將您的 APNs 證書上傳到 Firebase。如果您還沒有 APNs 證書,請確保在Apple Developer Member Center中創建一個。
在 Firebase 控制台的項目中,選擇齒輪圖標,選擇Project Settings ,然後選擇Cloud Messaging選項卡。
為您的開發證書、生產證書或兩者選擇上傳證書按鈕。至少需要一個。
對於每個證書,選擇 .p12 文件,並提供密碼(如果有)。確保此證書的捆綁包 ID 與您的應用的捆綁包 ID 匹配。選擇保存。
向用戶手機發送驗證碼
要啟動電話號碼登錄,請向用戶顯示一個界面,提示他們提供電話號碼,然後調用PhoneAuthProvider::VerifyPhoneNumber
以請求 Firebase 通過 SMS 向用戶的手機發送驗證碼:
獲取用戶的電話號碼。
法律要求各不相同,但作為最佳實踐並為您的用戶設定期望,您應該告知他們,如果他們使用電話登錄,他們可能會收到一條短信進行驗證,並適用標準費率。
- 調用
PhoneAuthProvider::VerifyPhoneNumber
,將用戶的電話號碼傳遞給它。class PhoneListener : public PhoneAuthProvider::Listener { public: ~PhoneListener() override {} void OnVerificationCompleted(Credential 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; PhoneAuthProvider& phone_provider = PhoneAuthProvider::GetInstance(auth); phone_provider->VerifyPhoneNumber(phone_number, kAutoVerifyTimeOut, null, &phone_listener);
當你調用PhoneAuthProvider::VerifyPhoneNumber
,Firebase,- (在 iOS 上)向您的應用發送靜默推送通知,
- 向指定的電話號碼發送包含驗證碼的 SMS 消息,並將驗證 ID 傳遞給您的完成函數。您將需要驗證碼和驗證 ID 才能登錄用戶。
保存驗證 ID 並在您的應用加載時恢復它。通過這樣做,如果您的應用在用戶完成登錄流程之前終止(例如,在切換到 SMS 應用時),您可以確保您仍然擁有有效的驗證 ID。
您可以以任何方式保留驗證 ID。如果您使用跨平台 C++ 框架編寫,它應該提供應用程序終止和恢復的通知。在這些事件中,您可以分別保存和恢復驗證 ID。
如果對VerifyPhoneNumber
的調用導致在偵聽器上調用OnCodeSent
,您可以在用戶在 SMS 消息中收到驗證碼時提示他們輸入驗證碼。
另一方面,如果對VerifyPhoneNumber
的調用導致OnVerificationCompleted
,則自動驗證已成功,您現在將擁有一個可以使用的Credential
,如下所述。
使用驗證碼登錄用戶
在用戶向您的應用提供 SMS 消息中的驗證碼後,通過從驗證碼和驗證 ID 創建一個Credential
對象並將該對像傳遞給Auth::SignInWithCredential
來登錄用戶。
- 從用戶那裡獲取驗證碼。
- 從驗證碼和驗證 ID 創建一個
Credential
對象。Credential credential = phone_auth_provider->GetCredential( verification_id_.c_str(), verification_code.c_str());
- 使用
Credential
對象登錄用戶:Future<User*> future = auth_->SignInWithCredential(credential); future.OnCompletion( [](const Future<User*>& result, void*) { if (result.error() == kAuthErrorNone) { // Successful. // User is signed in. const 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 != nullptr) { 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 實時數據庫和雲存儲安全規則中,您可以從
auth
變量中獲取登錄用戶的唯一用戶 ID,並使用它來控制用戶可以訪問哪些數據。
您可以通過將身份驗證提供程序憑據鏈接到現有用戶帳戶來允許用戶使用多個身份驗證提供程序登錄您的應用程序。
要註銷用戶,請調用SignOut()
:
auth->SignOut();