您可以使用 Firebase Authentication 建立及使用臨時匿名帳戶,向 Firebase 驗證身分。這些臨時匿名帳戶可讓尚未註冊應用程式的使用者,使用受安全性規則保護的資料。如果匿名使用者決定註冊應用程式,您可以將登入憑證連結至匿名帳戶,這樣他們就能在日後的工作階段中,繼續使用受保護的資料。
事前準備
- 將 Firebase 新增至 JavaScript 專案。
- 如果尚未將應用程式連結至 Firebase 專案,請前往 Firebase 控制台進行連結。
-
啟用匿名驗證:
- 在 Firebase 控制台中,依序前往 「Security」(安全性) >「Authentication」(驗證)。
- 在「登入方式」分頁中,啟用「匿名」登入供應商。
- 選用:如果已將專案升級至 Firebase Authentication with Identity Platform,可以啟用自動清理功能。啟用這項設定後,系統會自動刪除建立超過 30 天的匿名帳戶。在啟用自動清理功能的專案中,匿名驗證將不再計入用量限制或計費配額。請參閱「自動清理」。
以匿名方式向 Firebase 驗證
如果未登入的使用者使用需要 Firebase 驗證的應用程式功能,請完成下列步驟,以匿名方式登入使用者:
- 呼叫
signInAnonymously方法:您也可以在這裡擷取及處理錯誤。如需錯誤代碼清單,請參閱驗證參考文件。Web
import { getAuth, signInAnonymously } from "firebase/auth"; const auth = getAuth(); signInAnonymously(auth) .then(() => { // Signed in.. }) .catch((error) => { const errorCode = error.code; const errorMessage = error.message; // ... });
Web
firebase.auth().signInAnonymously() .then(() => { // Signed in.. }) .catch((error) => { var errorCode = error.code; var errorMessage = error.message; // ... });
- 如果
signInAnonymously方法順利完成,系統會觸發在onAuthStateChanged中註冊的觀察者,您也可以從User物件取得匿名使用者的帳戶資料:Web
import { getAuth, onAuthStateChanged } from "firebase/auth"; const auth = getAuth(); onAuthStateChanged(auth, (user) => { if (user) { // User is signed in, see docs for a list of available properties // https://firebase.google.com/docs/reference/js/auth.user const uid = user.uid; // ... } else { // User is signed out // ... } });
Web
firebase.auth().onAuthStateChanged((user) => { if (user) { // User is signed in, see docs for a list of available properties // https://firebase.google.com/docs/reference/js/v8/firebase.User var uid = user.uid; // ... } else { // User is signed out // ... } });
將匿名帳戶轉換為永久帳戶
當匿名使用者註冊應用程式時,您可能希望允許他們使用新帳戶繼續操作,例如,您可能希望將使用者在註冊前加入購物車的商品,提供給新帳戶的購物車。請以下列步驟完成實作:
- 使用者註冊時,請完成使用者驗證供應商的登入流程,直到呼叫其中一個
Auth.signInWith方法為止 (不含呼叫)。例如取得使用者的 Google ID 權杖、Facebook 存取權杖,或電子郵件地址和密碼。 為新的驗證供應商取得
AuthCredential:Google 登入
Web
import { GoogleAuthProvider } from "firebase/auth"; const credential = GoogleAuthProvider.credential( googleUser.getAuthResponse().id_token);
Web
var credential = firebase.auth.GoogleAuthProvider.credential( googleUser.getAuthResponse().id_token);
Facebook 登入
Web
import { FacebookAuthProvider } from "firebase/auth"; const credential = FacebookAuthProvider.credential( response.authResponse.accessToken);
Web
var credential = firebase.auth.FacebookAuthProvider.credential( response.authResponse.accessToken);
電子郵件/密碼登入
Web
import { EmailAuthProvider } from "firebase/auth"; const credential = EmailAuthProvider.credential(email, password);
Web
var credential = firebase.auth.EmailAuthProvider.credential(email, password);
將
AuthCredential物件傳遞至登入使用者的link方法:Web
import { getAuth, linkWithCredential } from "firebase/auth"; const auth = getAuth(); linkWithCredential(auth.currentUser, credential) .then((usercred) => { const user = usercred.user; console.log("Anonymous account successfully upgraded", user); }).catch((error) => { console.log("Error upgrading anonymous account", error); });
Web
auth.currentUser.linkWithCredential(credential) .then((usercred) => { var user = usercred.user; console.log("Anonymous account successfully upgraded", user); }).catch((error) => { console.log("Error upgrading anonymous account", error); });
如果對 link 的呼叫成功,使用者的新帳戶就能存取匿名帳戶的 Firebase 資料。
自動清理
如果已將專案升級至 Firebase Authentication with Identity Platform,可以在 Firebase 控制台啟用自動清理功能。啟用這項功能後,Firebase 就能自動刪除建立至今超過 30 天的匿名帳戶。在啟用自動清理功能的專案中,匿名驗證不會計入用量限制或計費配額。
- 啟用自動清理功能後,系統可能會在建立匿名帳戶 30 天後,隨時自動刪除該帳戶。
- 啟用自動清理功能後,現有的匿名帳戶會在 30 天後自動刪除。
- 如果關閉自動清理功能,系統仍會按照排程刪除匿名帳戶。
- 如果將匿名帳戶連結至任何登入方式,藉此「升級」帳戶,系統就不會自動刪除該帳戶。
如果您想在啟用這項功能前,先瞭解有多少使用者會受到影響,且已將專案升級至 Firebase Authentication with Identity Platform,可以在 Cloud Logging 中依 is_anon 篩選。
後續步驟
現在使用者可以透過 Firebase 進行驗證,您可以使用 Firebase 規則,控管他們對 Firebase 資料庫中資料的存取權。