使用 C++ 透過 Firebase 進行匿名身份驗證

您可以使用 Firebase 身份驗證來創建和使用臨時匿名帳戶來通過 Firebase 進行身份驗證。這些臨時匿名帳戶可用於允許尚未註冊您的應用的用戶使用受安全規則保護的數據。如果匿名用戶決定註冊您的應用程序,您可以將他們的登錄憑據鏈接到匿名帳戶,以便他們可以在以後的會話中繼續使用受保護的數據。

在你開始之前

  1. 將 Firebase 添加到您的 C++ 項目中。
  2. 如果您尚未將應用連接到 Firebase 項目,請從Firebase 控制台執行此操作。
  3. 啟用匿名身份驗證:
    1. Firebase 控制台中,打開Auth部分。
    2. 登錄方法頁面上,啟用匿名登錄方法。
    3. 可選:如果您已使用 Identity Platform 將項目升級到 Firebase 身份驗證,則可以啟用自動清理。啟用此設置後,超過 30 天的匿名帳戶將被自動刪除。在啟用自動清理的項目中,匿名身份驗證將不再計入使用限製或計費配額。請參閱自動清理

匿名使用 Firebase 進行身份驗證

當已註銷的用戶使用需要通過 Firebase 進行身份驗證的應用功能時,請完成以下步驟以匿名方式登錄該用戶:

Auth類是所有 API 調用的網關。
  1. 添加 Auth 和 App 頭文件:
    #include "firebase/app.h"
    #include "firebase/auth.h"
    
  2. 在您的初始化代碼中,創建一個firebase::App類。
    #if defined(__ANDROID__)
      firebase::App* app =
          firebase::App::Create(firebase::AppOptions(), my_jni_env, my_activity);
    #else
      firebase::App* app = firebase::App::Create(firebase::AppOptions());
    #endif  // defined(__ANDROID__)
    
  3. 為您的firebase::App獲取firebase::auth::Auth類。 AppAuth之間存在一對一的映射關係。
    firebase::auth::Auth* auth = firebase::auth::Auth::GetAuth(app);
    
  • 調用Auth::SignInAnonymously
    firebase::Future<firebase::auth::AuthResult> result =
        auth->SignInAnonymously();
    
  • 如果您的程序有一個定期運行的更新循環(例如每秒 30 或 60 次),您可以使用Auth::SignInAnonymouslyLastResult每次更新檢查一次結果:
    firebase::Future<firebase::auth::AuthResult> result =
        auth->SignInAnonymouslyLastResult();
    if (result.status() == firebase::kFutureStatusComplete) {
      if (result.error() == firebase::auth::kAuthErrorNone) {
        firebase::auth::AuthResult auth_result = *result.result();
        printf("Sign in succeeded for `%s`\n",
               auth_result.user.display_name().c_str());
      } else {
        printf("Sign in failed with error '%s'\n", result.error_message());
      }
    }
    
    或者,如果您的程序是事件驅動的,您可能更喜歡在 Future 上註冊回調
  • 將匿名帳戶轉換為永久帳戶

    當匿名用戶註冊您的應用程序時,您可能希望允許他們使用新帳戶繼續工作——例如,您可能希望讓用戶在註冊之前添加到購物車中的商品在他們的新帳戶中可用帳戶的購物車。為此,請完成以下步驟:

    1. 當用戶註冊時,為用戶的身份驗證提供程序完成登錄流程,直至但不包括調用Auth::SignInWith方法之一。例如,獲取用戶的 Google ID 令牌、Facebook 訪問令牌或電子郵件地址和密碼。
    2. 獲取新身份驗證提供程序的auth::Credential

      谷歌登錄
      firebase::auth::Credential credential =
          firebase::auth::GoogleAuthProvider::GetCredential(google_id_token,
                                                            nullptr);
      
      Facebook 登錄
      firebase::auth::Credential credential =
          firebase::auth::FacebookAuthProvider::GetCredential(access_token);
      
      電子郵件密碼登錄
      firebase::auth::Credential credential =
          firebase::auth::EmailAuthProvider::GetCredential(email, password);
      
    3. auth::Credential對像傳遞給登錄用戶的LinkWithCredential方法:

      // Link the new credential to the currently active user.
      firebase::auth::User current_user = auth->current_user();
      firebase::Future<firebase::auth::AuthResult> result =
          current_user.LinkWithCredential(credential);
      

    如果對LinkWithCredential的調用成功,則用戶的新帳戶可以訪問匿名帳戶的 Firebase 數據。

    自動清理

    如果您已使用 Identity Platform 將項目升級到 Firebase 身份驗證,則可以在 Firebase 控制台中啟用自動清理。當您啟用此功能時,Firebase 會自動刪除超過 30 天的匿名帳戶。在啟用自動清理的項目中,匿名身份驗證將不計入使用限製或計費配額。

    • 在啟用自動清理後創建的任何匿名帳戶可能會在創建後 30 天后的任何時間自動刪除。
    • 在啟用自動清理之前創建的匿名帳戶將有資格在啟用自動清理後 30 天開始自動刪除。
    • 如果您關閉自動清理,任何預定被刪除的匿名帳戶將保持預定被刪除。這些帳戶不計入使用限製或計費配額。
    • 如果您通過將匿名帳戶鏈接到任何登錄方法來“升級”匿名帳戶,則該帳戶不會被自動刪除。

    如果您想在啟用此功能之前查看有多少用戶會受到影響,並且您已將項目升級到使用 Identity Platform 的 Firebase 身份驗證,則可以在Cloud Logging中按is_anon進行過濾。

    下一步

    現在用戶可以使用 Firebase 進行身份驗證,您可以使用Firebase 規則控制他們對 Firebase 數據庫中數據的訪問。