使用 JavaScript 匿名以 Firebase 驗證

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

事前準備

  1. 將 Firebase 新增至 JavaScript 專案。
  2. 如果尚未將應用程式連結至 Firebase 專案,請前往 Firebase 控制台進行連結。
  3. 啟用匿名驗證:
    1. 在 Firebase 控制台中,依序前往 「Security」(安全性) >「Authentication」(驗證)。
    2. 在「登入方式」分頁中,啟用「匿名」登入供應商。
    3. 選用:如果已將專案升級至 Firebase Authentication with Identity Platform,可以啟用自動清理功能。啟用這項設定後,系統會自動刪除建立超過 30 天的匿名帳戶。在啟用自動清理功能的專案中,匿名驗證將不再計入用量限制或計費配額。請參閱「自動清理」。

以匿名方式向 Firebase 驗證

如果未登入的使用者使用需要 Firebase 驗證的應用程式功能,請完成下列步驟,以匿名方式登入使用者:

  1. 呼叫 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;
        // ...
      });
    您也可以在這裡擷取及處理錯誤。如需錯誤代碼清單,請參閱驗證參考文件。
  2. 如果 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
        // ...
      }
    });

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

當匿名使用者註冊應用程式時,您可能希望允許他們使用新帳戶繼續操作,例如,您可能希望將使用者在註冊前加入購物車的商品,提供給新帳戶的購物車。請以下列步驟完成實作:

  1. 使用者註冊時,請完成使用者驗證供應商的登入流程,直到呼叫其中一個 Auth.signInWith 方法為止 (不含呼叫)。例如取得使用者的 Google ID 權杖、Facebook 存取權杖,或電子郵件地址和密碼。
  2. 為新的驗證供應商取得 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);
  3. 將 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 資料庫中資料的存取權。