使用 JavaScript 匿名以 Firebase 驗證

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

事前準備

1. 將 Firebase 新增至您的 JavaScript 專案。
2. 如果您尚未將應用程式連結至 Firebase 專案，請透過 Firebase 控制台進行。
3. 啟用匿名驗證功能：
   1. 在 Firebase 控制台開啟「驗證」專區。
   2. 在「Sign-in Methods」頁面中，啟用「Anonymous」登入方式。
   3. 選用：如果您已將專案升級為透過 Identity Platform 使用 Firebase 驗證，可以啟用自動清理功能。啟用這項設定後，系統會自動刪除 30 天前的匿名帳戶。如果專案已啟用自動清理功能，匿名驗證就不會計入用量限製或帳單配額。請參閱自動清除一節。

透過 Firebase 匿名驗證

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

1. 呼叫 signInAnonymously 方法：

   網頁模組 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

   網路命名空間 API

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

   您也能在這裡找出並處理錯誤。如需錯誤代碼清單，請參閱驗證參考文件。
2. 如果 signInAnonymously 方法在沒有錯誤的情況下完成，在 onAuthStateChanged 中註冊的觀察器會觸發，您可以透過 User 物件取得匿名使用者的帳戶資料：

   網頁模組 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

   網路命名空間 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

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

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

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

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

   Google 登入

   網頁模組 API

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

   網路命名空間 API

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

   Facebook 登入

   網頁模組 API

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

   網路命名空間 API

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

   使用電子郵件密碼登入

   網頁模組 API

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

   網路命名空間 API

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

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

   網頁模組 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

   網路命名空間 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 資料。

自動清理

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

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

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

後續步驟

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