您可以使用 Firebase 驗證來建立暫時匿名帳戶,並使用 Firebase 進行驗證。這些臨時匿名帳戶可用於讓尚未註冊您應用程式的使用者,使用受安全性規則保護的資料。如果匿名使用者決定註冊您的應用程式,您可以將他們的登入憑證連結至匿名帳戶,方便他們在日後的工作階段中繼續使用已保護的資料。
事前準備
- 如果您尚未將 Firebase 新增至 Android 專案,請先完成這項操作。
-
在模組 (應用程式層級) 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.1")) // 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") }
- 如果您尚未將應用程式連結至 Firebase 專案,請透過 Firebase 控制台進行。
- 啟用匿名驗證功能:
- 在 Firebase 控制台開啟「驗證」專區。
- 在「Sign-in Methods」頁面中,啟用「Anonymous」登入方式。
- 選用:如果您已將專案升級為透過 Identity Platform 使用 Firebase 驗證,可以啟用自動清理功能。啟用這項設定後,系統會自動刪除 30 天前的匿名帳戶。如果專案已啟用自動清理功能,匿名驗證就不會計入用量限製或帳單配額。請參閱自動清除一節。
透過 Firebase 匿名驗證
當登出的使用者使用需要透過 Firebase 進行驗證的應用程式功能時,請完成下列步驟,以匿名的方式登入使用者:
- 在活動的
onCreate
方法中,取得FirebaseAuth
物件的共用例項:Kotlin+KTX
private lateinit var auth: FirebaseAuth // ... // Initialize Firebase Auth auth = Firebase.auth
Java
private FirebaseAuth mAuth; // ... // Initialize Firebase Auth mAuth = FirebaseAuth.getInstance();
- 初始化「活動」時,請檢查使用者目前是否登入:
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) }
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); }
- 最後,呼叫
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) } }
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); } } });
getCurrentUser
方法取得使用者的帳戶資料。
將匿名帳戶轉換為永久帳戶
當您匿名使用者註冊您的應用程式時,您可能會想讓他們透過新帳戶繼續完成工作;舉例來說,您可能希望在使用者註冊使用新帳戶的購物車前,將他們加入購物車的商品加入購物車。如要這樣做,請完成下列步驟:
- 使用者註冊時,請完成使用者驗證服務供應商的登入流程,但不含呼叫其中一個
FirebaseAuth.signInWith
方法。例如,取得使用者的 Google ID 權杖、Facebook 存取權杖,或電子郵件地址和密碼。 取得新驗證供應商的
AuthCredential
:Google 登入
Kotlin+KTX
val credential = GoogleAuthProvider.getCredential(googleIdToken, null)
Java
AuthCredential credential = GoogleAuthProvider.getCredential(googleIdToken, null);
Facebook 登入
Kotlin+KTX
val credential = FacebookAuthProvider.getCredential(token.token)
Java
AuthCredential credential = FacebookAuthProvider.getCredential(token.getToken());
使用電子郵件密碼登入
Kotlin+KTX
val credential = EmailAuthProvider.getCredential(email, password)
Java
AuthCredential credential = EmailAuthProvider.getCredential(email, password);
將
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) } }
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); } } });
如果呼叫 linkWithCredential
成功,使用者的新帳戶可以存取匿名帳戶的 Firebase 資料。
自動清理
如果您已將專案升級為透過 Identity Platform 使用 Firebase 驗證,即可在 Firebase 控制台啟用自動清除功能。啟用這項功能即代表您允許 Firebase 自動刪除 30 天前的匿名帳戶。如果專案已啟用自動清理功能,匿名驗證就不會計入用量限製或帳單配額。
- 啟用自動清理功能之後,建立的所有匿名帳戶可能會在建立 30 天後自動刪除。
- 啟用自動清除功能後,現有的匿名帳戶會在 30 天後自動刪除。
- 停用自動清除功能後,所有已排定刪除的匿名帳戶都會維持排定的刪除狀態。
- 如果您以連結任何登入方式「升級」匿名帳戶,系統不會自動刪除該帳戶。
如果您想在啟用這項功能前瞭解會受到影響的使用者人數,並已將專案升級至透過 Identity Platform 進行 Firebase 驗證,可以在 Cloud Logging 中使用 is_anon
進行篩選。
後續步驟
現在使用者可以透過 Firebase 進行驗證,因此您可以使用 Firebase 規則控管他們對 Firebase 資料庫資料的存取權。