在 Android 上透過 Firebase 匿名驗證

您可以使用 Firebase 驗證來建立暫時匿名帳戶，並使用 Firebase 進行驗證。這些臨時匿名帳戶可用於讓尚未註冊您應用程式的使用者，使用受安全性規則保護的資料。如果匿名使用者決定註冊您的應用程式，您可以將他們的登入憑證連結至匿名帳戶，方便他們在日後的工作階段中繼續使用已保護的資料。

事前準備

1. 如果您尚未將 Firebase 新增至 Android 專案，請先完成這項操作。
2. 在模組 (應用程式層級) Gradle 檔案 (通常是 <project>/<app-module>/build.gradle.kts 或 <project>/<app-module>/build.gradle) 中，新增 Android 專用 Firebase 驗證程式庫的依附元件。

   dependencies {
       // Import the BoM for the Firebase platform
       implementation(platform("com.google.firebase:firebase-bom:33.1.0"))
   
       // Add the dependency for the Firebase Authentication library
       // When using the BoM, you don't specify versions in Firebase library dependencies
       implementation("com.google.firebase:firebase-auth")
   }
   

   只要使用 Firebase Android BoM，您的應用程式就會一律使用相容的 Firebase Android 程式庫版本。

   (替代做法) 新增 Firebase 程式庫依附元件，「不」使用 BoM

   如果選擇不使用 Firebase BoM，就必須在依附元件行中指定每個 Firebase 程式庫版本。

   請注意，如果您在應用程式中使用多個 Firebase 程式庫，強烈建議您使用 BoM 來管理程式庫版本，以確保所有版本都相容。

   dependencies {
       // Add the dependency for the Firebase Authentication library
       // When NOT using the BoM, you must specify versions in Firebase library dependencies
       implementation("com.google.firebase:firebase-auth:23.0.0")
   }
   

   在尋找 Kotlin 專用的程式庫模組嗎？自 2023 年 10 月 (Firebase BoM 32.5.0) 起，Kotlin 和 Java 開發人員都能使用主要的程式庫模組 (詳情請參閱這項計畫的常見問題)。
3. 如果您尚未將應用程式連結至 Firebase 專案，請透過 Firebase 控制台進行。
4. 啟用匿名驗證功能：
   1. 在 Firebase 控制台開啟「驗證」專區。
   2. 在「Sign-in Methods」頁面中，啟用「Anonymous」登入方式。
   3. 選用：如果您已將專案升級為透過 Identity Platform 使用 Firebase 驗證，可以啟用自動清理功能。啟用這項設定後，系統會自動刪除 30 天前的匿名帳戶。如果專案已啟用自動清理功能，匿名驗證就不會計入用量限製或帳單配額。請參閱自動清除一節。

透過 Firebase 匿名驗證

當登出的使用者使用需要透過 Firebase 進行驗證的應用程式功能時，請完成下列步驟，以匿名的方式登入使用者：

1. 在活動的 onCreate 方法中，取得 FirebaseAuth 物件的共用例項：

   Kotlin+KTX

   private lateinit var auth: FirebaseAuth
   // ...
   // Initialize Firebase Auth
   auth = Firebase.auth
   AnonymousAuthActivity.kt

   Java

   private FirebaseAuth mAuth;
   // ...
   // Initialize Firebase Auth
   mAuth = FirebaseAuth.getInstance();
   AnonymousAuthActivity.java

2. 初始化「活動」時，請檢查使用者目前是否登入：

   Kotlin+KTX

   public override fun onStart() {
       super.onStart()
       // Check if user is signed in (non-null) and update UI accordingly.
       val currentUser = auth.currentUser
       updateUI(currentUser)
   }
   AnonymousAuthActivity.kt

   Java

   @Override
   public void onStart() {
       super.onStart();
       // Check if user is signed in (non-null) and update UI accordingly.
       FirebaseUser currentUser = mAuth.getCurrentUser();
       updateUI(currentUser);
   }
   AnonymousAuthActivity.java

3. 最後，呼叫 signInAnonymously 以匿名使用者身分登入：

   Kotlin+KTX

   auth.signInAnonymously()
       .addOnCompleteListener(this) { task ->
           if (task.isSuccessful) {
               // Sign in success, update UI with the signed-in user's information
               Log.d(TAG, "signInAnonymously:success")
               val user = auth.currentUser
               updateUI(user)
           } else {
               // If sign in fails, display a message to the user.
               Log.w(TAG, "signInAnonymously:failure", task.exception)
               Toast.makeText(
                   baseContext,
                   "Authentication failed.",
                   Toast.LENGTH_SHORT,
               ).show()
               updateUI(null)
           }
       }
   AnonymousAuthActivity.kt

   Java

   mAuth.signInAnonymously()
           .addOnCompleteListener(this, new OnCompleteListener<AuthResult>() {
               @Override
               public void onComplete(@NonNull Task<AuthResult> task) {
                   if (task.isSuccessful()) {
                       // Sign in success, update UI with the signed-in user's information
                       Log.d(TAG, "signInAnonymously:success");
                       FirebaseUser user = mAuth.getCurrentUser();
                       updateUI(user);
                   } else {
                       // If sign in fails, display a message to the user.
                       Log.w(TAG, "signInAnonymously:failure", task.getException());
                       Toast.makeText(AnonymousAuthActivity.this, "Authentication failed.",
                               Toast.LENGTH_SHORT).show();
                       updateUI(null);
                   }
               }
           });
   AnonymousAuthActivity.java

   如果登入成功，您就可以使用 getCurrentUser 方法取得使用者的帳戶資料。

為防止專案遭到濫用，Firebase 會限制應用程式在短時間內可透過相同 IP 位址使用的新電子郵件/密碼和匿名註冊次數。您可以透過 Firebase 控制台要求取得配額的暫時變更，並排定變更時程。

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

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

1. 使用者註冊時，請完成使用者驗證服務供應商的登入流程，但不含呼叫其中一個 FirebaseAuth.signInWith 方法。例如，取得使用者的 Google ID 權杖、Facebook 存取權杖，或電子郵件地址和密碼。

2. 取得新驗證供應商的 AuthCredential：

   Google 登入

   Kotlin+KTX

   val credential = GoogleAuthProvider.getCredential(googleIdToken, null)
   MainActivity.kt

   Java

   AuthCredential credential = GoogleAuthProvider.getCredential(googleIdToken, null);
   MainActivity.java

   Facebook 登入

   Kotlin+KTX

   val credential = FacebookAuthProvider.getCredential(token.token)
   MainActivity.kt

   Java

   AuthCredential credential = FacebookAuthProvider.getCredential(token.getToken());
   MainActivity.java

   使用電子郵件密碼登入

   Kotlin+KTX

   val credential = EmailAuthProvider.getCredential(email, password)
   MainActivity.kt

   Java

   AuthCredential credential = EmailAuthProvider.getCredential(email, password);
   MainActivity.java

3. 將 AuthCredential 物件傳遞至登入使用者的 linkWithCredential 方法：

   Kotlin+KTX

   auth.currentUser!!.linkWithCredential(credential)
       .addOnCompleteListener(this) { task ->
           if (task.isSuccessful) {
               Log.d(TAG, "linkWithCredential:success")
               val user = task.result?.user
               updateUI(user)
           } else {
               Log.w(TAG, "linkWithCredential:failure", task.exception)
               Toast.makeText(
                   baseContext,
                   "Authentication failed.",
                   Toast.LENGTH_SHORT,
               ).show()
               updateUI(null)
           }
       }
   AnonymousAuthActivity.kt

   Java

   mAuth.getCurrentUser().linkWithCredential(credential)
           .addOnCompleteListener(this, new OnCompleteListener<AuthResult>() {
               @Override
               public void onComplete(@NonNull Task<AuthResult> task) {
                   if (task.isSuccessful()) {
                       Log.d(TAG, "linkWithCredential:success");
                       FirebaseUser user = task.getResult().getUser();
                       updateUI(user);
                   } else {
                       Log.w(TAG, "linkWithCredential:failure", task.getException());
                       Toast.makeText(AnonymousAuthActivity.this, "Authentication failed.",
                               Toast.LENGTH_SHORT).show();
                       updateUI(null);
                   }
               }
           });
   AnonymousAuthActivity.java

如果呼叫 linkWithCredential 成功，使用者的新帳戶可以存取匿名帳戶的 Firebase 資料。

這個方法也可用來連結任一兩個帳戶。

自動清理

如果您已將專案升級為透過 Identity Platform 使用 Firebase 驗證，即可在 Firebase 控制台啟用自動清除功能。啟用這項功能即代表您允許 Firebase 自動刪除 30 天前的匿名帳戶。如果專案已啟用自動清理功能，匿名驗證就不會計入用量限製或帳單配額。

• 啟用自動清理功能之後，建立的所有匿名帳戶可能會在建立 30 天後自動刪除。
• 啟用自動清除功能後，現有的匿名帳戶會在 30 天後自動刪除。
• 停用自動清除功能後，所有已排定刪除的匿名帳戶都會維持排定的刪除狀態。
• 如果您以連結任何登入方式「升級」匿名帳戶，系統不會自動刪除該帳戶。

如果您想在啟用這項功能前瞭解會受到影響的使用者人數，並已將專案升級至透過 Identity Platform 進行 Firebase 驗證，可以在 Cloud Logging 中使用 is_anon 進行篩選。

後續步驟

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