使用 JavaScript 透過 Firebase 進行匿名身份驗證

您可以使用 Firebase 驗證建立並使用臨時匿名帳戶來透過 Firebase 進行驗證。這些臨時匿名帳戶可用於允許尚未註冊您的應用程式的使用者使用受安全規則保護的資料。如果匿名使用者決定註冊您的應用程序，您可以將他們的登入憑證連結到匿名帳戶，以便他們可以在將來的會話中繼續使用受保護的資料。

在你開始之前

1. 將 Firebase 新增到您的 JavaScript 專案。
2. 如果您尚未將應用程式連線至 Firebase 項目，請從Firebase 控制台執行此操作。
3. 啟用匿名身份驗證：
   1. 在Firebase 控制台中，開啟「驗證」部分。
   2. 在登入方法頁面上，啟用匿名登入方法。
   3. 可選：如果您已將專案升級至具有 Identity Platform 的 Firebase 驗證，則可以啟用自動清理。啟用此設定後，超過 30 天的匿名帳戶將自動刪除。在啟用自動清理的項目中，匿名身分驗證將不再計入使用限製或計費配額。請參閱自動清理。

使用 Firebase 進行匿名身份驗證

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

1. 呼叫signInAnonymously方法：

   Web modular API

   詳細了解可樹搖動的模組化 Web API 以及從命名空間 API進行升級。

   import { getAuth, signInAnonymously } from "firebase/auth";
   
   const auth = getAuth();
   signInAnonymously(auth)
     .then(() => {
       // Signed in..
     })
     .catch((error) => {
       const errorCode = error.code;
       const errorMessage = error.message;
       // ...
     });
   auth_anon_sign_in.js

   Web namespaced API

   firebase.auth().signInAnonymously()
     .then(() => {
       // Signed in..
     })
     .catch((error) => {
       var errorCode = error.code;
       var errorMessage = error.message;
       // ...
     });
   anonymous.js

   這也是您可以捕獲和處理錯誤的地方。有關錯誤代碼的列表，請查看Auth Reference Docs 。
2. 如果signInAnonymously方法完成且沒有錯誤，則在onAuthStateChanged中註冊的觀察者將被觸發，您可以從User物件中取得匿名使用者的帳戶資料：

   Web modular API

   詳細了解可樹搖動的模組化 Web API 以及從命名空間 API進行升級。

   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
       // ...
     }
   });
   auth_state_listener.js

   Web namespaced API

   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
       // ...
     }
   });
   index.js

為了保護您的專案免於濫用，Firebase 限制您的應用程式在短時間內可以從相同 IP 位址進行的新電子郵件/密碼和匿名註冊的數量。您可以從Firebase 控制台請求並安排對此配額的臨時變更。

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

重要提示：有一個已知問題會導致linkWithCredentials()在某些專案中無法正常運作。請參閱問題報告以了解解決方法和修復狀態。

當匿名用戶註冊您的應用程式時，您可能希望允許他們使用新帳戶繼續工作 - 例如，您可能希望讓用戶在註冊之前添加到購物車的商品在他們的新帳戶中可用帳戶的購物車。為此，請完成以下步驟：

1. 當使用者註冊時，完成使用者驗證提供者的登入流程，直到（但不包括）呼叫Auth.signInWith方法之一。例如，取得使用者的 Google ID 令牌、Facebook 存取權令牌或電子郵件地址和密碼。

2. 取得新身分驗證提供者的AuthCredential ：

   Google登入

   Web modular API

   詳細了解可樹搖動的模組化 Web API 以及從命名空間 API進行升級。

   import { GoogleAuthProvider } from "firebase/auth";
   
   const credential = GoogleAuthProvider.credential(
     googleUser.getAuthResponse().id_token);
   auth_make_google_credential.js

   Web namespaced API

   var credential = firebase.auth.GoogleAuthProvider.credential(
     googleUser.getAuthResponse().id_token);
   index.js

   Facebook登入

   Web modular API

   詳細了解可樹搖動的模組化 Web API 以及從命名空間 API進行升級。

   import { FacebookAuthProvider } from "firebase/auth";
   
   const credential = FacebookAuthProvider.credential(
     response.authResponse.accessToken);
   auth_make_facebook_credential.js

   Web namespaced API

   var credential = firebase.auth.FacebookAuthProvider.credential(
     response.authResponse.accessToken);
   index.js

   郵件信箱密碼登入

   Web modular API

   詳細了解可樹搖動的模組化 Web API 以及從命名空間 API進行升級。

   import { EmailAuthProvider } from "firebase/auth";
   
   const credential = EmailAuthProvider.credential(email, password);
   auth_make_email_credential.js

   Web namespaced API

   var credential = firebase.auth.EmailAuthProvider.credential(email, password);
   link-multiple-accounts.js

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

   Web modular API

   詳細了解可樹搖動的模組化 Web API 以及從命名空間 API進行升級。

   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);
     });
   auth_anonymous_link.js

   Web namespaced API

   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-multiple-accounts.js

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

此技術也可用於連結任兩個帳戶。

自動清理

如果您已將專案升級至Firebase Authentication with Identity Platform ，則可以在 Firebase 控制台中啟用自動清理。啟用此功能後，您允許 Firebase 自動刪除超過 30 天的匿名帳戶。在啟用自動清理的項目中，匿名身分驗證將不計入使用限製或計費配額。

• 啟用自動清理後建立的任何匿名帳戶可能會在建立後 30 天後隨時自動刪除。
• 啟用自動清理之前建立的匿名帳戶將在啟用自動清理後 30 天後符合自動刪除資格。
• 如果您關閉自動清理，任何計劃刪除的匿名帳戶仍將保留計劃刪除。這些帳戶不計入使用限製或計費配額。
• 如果您透過將匿名帳戶連結到任何登入方法來「升級」該帳戶，則該帳戶不會自動刪除。

如果您想在啟用此功能之前了解有多少使用者會受到影響，並且您已將專案升級到使用 Identity Platform 進行 Firebase 驗證，則可以在Cloud Logging中按is_anon進行篩選。

下一步

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