使用 C++ 以匿名方式進行 Firebase 驗證

您可以使用 Firebase Authentication 建立及使用臨時匿名帳戶，向 Firebase 驗證身分。這些臨時匿名帳戶可供尚未註冊應用程式的使用者，處理受安全性規則保護的資料。如果匿名使用者決定註冊應用程式，您可以將登入憑證連結至匿名帳戶，讓他們在日後的工作階段中繼續使用受保護的資料。

事前準備

1. 將 Firebase 新增至 C++ 專案。
2. 如果尚未將應用程式連結至 Firebase 專案，請從 Firebase 控制台進行連結。
3. 啟用匿名驗證：
   1. 在 Firebase 控制台中，開啟「Auth」(驗證) 專區。
   2. 在「登入方式」頁面中，啟用「匿名」登入方式。
   3. 選用：如果已將專案升級至 Firebase Authentication with Identity Platform，可以啟用自動清除功能。啟用這項設定後，系統就會自動刪除建立至今超過 30 天的匿名帳戶。在啟用自動清除功能的專案中，匿名驗證將不再計入用量限制或計費配額。請參閱「自動清除」一節。

以匿名方式向 Firebase 進行驗證

如果使用者在登出後使用需要透過 Firebase 驗證身分的應用程式功能，請完成下列步驟，以匿名方式登入使用者：

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 類別。 App 和 Auth 之間是一對一的對應關係。

   firebase::auth::Auth* auth = firebase::auth::Auth::GetAuth(app);

firebase::Future<firebase::auth::AuthResult> result =
    auth->SignInAnonymously();

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

將匿名帳戶轉換為永久帳戶

當匿名使用者註冊應用程式時，您可能希望允許他們使用新帳戶繼續工作，例如，您可能希望讓使用者在註冊前加入購物車的商品，在新帳戶的購物車中也能使用。如要這樣做，請完成下列步驟：

1. 使用者註冊時，請完成使用者驗證供應商的登入流程，但不要呼叫 Auth::SignInWith 方法。例如，取得使用者的 Google ID 權杖、Facebook 存取權杖，或是電子郵件地址和密碼。

2. 取得新驗證供應商的 auth::Credential：

   Google 登入

   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 資料。

自動清除

如果專案已升級至 Firebase Authentication with Identity Platform，您可以在 Firebase 控制台中啟用自動清除功能。啟用這項功能後，Firebase 就會自動刪除建立至今超過 30 天的匿名帳戶。如果專案啟用自動清除功能，匿名驗證就不會計入用量限制或計費配額。

• 啟用自動清理功能後，系統可能會在匿名帳戶建立 30 天後，隨時自動刪除這些帳戶。
• 啟用自動清理功能後，現有的匿名帳戶會在 30 天後自動刪除。
• 如果關閉自動清理功能，系統仍會按照排程刪除匿名帳戶。
• 如果您將匿名帳戶連結至任何登入方式來「升級」帳戶，系統就不會自動刪除該帳戶。

如要在啟用這項功能前，查看會受到影響的使用者人數，且您已將專案升級至 Firebase Authentication with Identity Platform，則可以在 Cloud Logging 中依 is_anon 進行篩選。

後續步驟

使用者現在可以透過 Firebase 進行驗證，您可以使用 Firebase 規則控管使用者對 Firebase 資料庫中資料的存取權。