本頁面由 Cloud Translation API 翻譯而成。

使用 JavaScript 匿名以 Firebase 驗證

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

事前準備

將 Firebase 新增至 JavaScript 專案。
如果您尚未將應用程式連結至 Firebase 專案，請透過 Firebase 主控台連結。
啟用匿名驗證：
1. 在 Firebase 控制台中，開啟「Auth」部分。
2. 在「Sign-in Methods」頁面中，啟用「Anonymous」登入方法。
3. 選用：如果您已將專案升級至 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;
    // ...
  });auth_anon_sign_in.js

Web

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

您也可以在這裡捕捉及處理錯誤。如需錯誤代碼清單，請參閱 Auth 參考文件。

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

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

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

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

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

取得新驗證供應器的 AuthCredential：

Web

import { GoogleAuthProvider } from "firebase/auth";

const credential = GoogleAuthProvider.credential(
  googleUser.getAuthResponse().id_token);auth_make_google_credential.js

Web

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

Web

import { FacebookAuthProvider } from "firebase/auth";

const credential = FacebookAuthProvider.credential(
  response.authResponse.accessToken);auth_make_facebook_credential.js

Web

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

Web

import { EmailAuthProvider } from "firebase/auth";

const credential = EmailAuthProvider.credential(email, password);auth_make_email_credential.js

Web

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

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

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

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

自動清除

如果您已將專案升級至 Firebase Authentication with Identity Platform，可以在 Firebase 主控台中啟用自動清理功能。啟用這項功能後，Firebase 就會自動刪除建立至今超過 30 天的匿名帳戶。在啟用自動清理功能的專案中，匿名驗證不會計入用量限制或計費配額。

啟用自動清理功能後建立的所有匿名帳戶，可能會在建立後 30 天後的任何時間自動刪除。
啟用自動清理功能後，現有的匿名帳戶會在 30 天後自動刪除。
如果您關閉自動清理功能，所有已排定要刪除的匿名帳戶都會維持原先的刪除排程。
如果您將匿名帳戶連結至任何登入方式，系統就不會自動刪除該帳戶。

如果您想在啟用這項功能前查看受影響的使用者人數，且已將專案升級至 Firebase Authentication with Identity Platform，可以在 Cloud Logging 中依 is_anon 篩選。

後續步驟

使用者現在可以透過 Firebase 驗證，您可以使用 Firebase 規則控制使用者對 Firebase 資料庫中資料的存取權。