使用 Firebase JS SDK 時,您可以指定驗證狀態的保存方式。包括指定已登入的使用者是否應無限期保留,直到明確登出、視窗關閉時清除,或在頁面重新載入時清除。
如果是網頁應用程式,預設行為是在使用者關閉瀏覽器後,仍保留使用者工作階段。這樣一來,使用者就不必每次在同一部裝置上造訪網頁時,都要重新登入,相當方便。這可能需要使用者重新輸入密碼、傳送簡訊驗證等,可能會大幅增加使用者體驗的摩擦。
不過,在某些情況下,這種行為可能不理想:
- 如果應用程式含有機密資料,建議在視窗或分頁關閉時清除狀態。如果使用者忘記登出,這項功能就非常重要。
- 在多位使用者共用的裝置上使用的應用程式。常見的例子是在圖書館電腦上執行的應用程式。
- 共用裝置上的應用程式,可能有多位使用者存取。開發人員無法得知該應用程式的存取方式,可能想讓使用者選擇是否要保留工作階段。例如在登入時加入「記住我」選項。
- 在某些情況下,開發人員可能不希望保留匿名使用者,直到該使用者升級為非匿名帳戶 (聯合、密碼、電話等)。
- 開發人員可能希望允許不同使用者在不同分頁登入應用程式。預設行為是保留相同來源的分頁狀態。
如上所述,在多種情況下,可能需要覆寫預設的永久持續性。
支援的驗證狀態持續性類型
您可以根據應用程式或使用者的需求,在指定的 Firebase Auth 執行個體上,選擇三種驗證狀態持續性類型之一。
| 列舉 | 值 | 說明 |
|---|---|---|
firebase.auth.Auth.Persistence.LOCAL |
'local' | 表示即使瀏覽器視窗關閉或 React Native 中的活動遭到刪除,狀態仍會保留。必須明確登出才能清除該狀態。請注意,Firebase Auth 網頁工作階段是單一主機來源,且只會保留在單一網域。 |
firebase.auth.Auth.Persistence.SESSION |
'session' | 表示狀態只會保留在目前的工作階段或分頁中,並在使用者驗證的分頁或視窗關閉時清除。僅適用於網頁應用程式。 |
firebase.auth.Auth.Persistence.NONE |
'none' | 表示狀態只會儲存在記憶體中,並在視窗或活動重新整理時清除。 |
修改驗證狀態持續性
您可以呼叫 firebase.auth().setPersistence 方法,指定或修改現有的持續性類型:
Web
import { getAuth, setPersistence, signInWithEmailAndPassword, browserSessionPersistence } from "firebase/auth"; const auth = getAuth(); setPersistence(auth, browserSessionPersistence) .then(() => { // Existing and future Auth states are now persisted in the current // session only. Closing the window would clear any existing state even // if a user forgets to sign out. // ... // New sign-in will be persisted with session persistence. return signInWithEmailAndPassword(auth, email, password); }) .catch((error) => { // Handle Errors here. const errorCode = error.code; const errorMessage = error.message; });
Web
firebase.auth().setPersistence(firebase.auth.Auth.Persistence.SESSION) .then(() => { // Existing and future Auth states are now persisted in the current // session only. Closing the window would clear any existing state even // if a user forgets to sign out. // ... // New sign-in will be persisted with session persistence. return firebase.auth().signInWithEmailAndPassword(email, password); }) .catch((error) => { // Handle Errors here. var errorCode = error.code; var errorMessage = error.message; });
這項操作會變更指定 Auth 執行個體上目前儲存的 Auth 工作階段持續性類型,並將這類持續性套用至日後的登入要求,包括透過重新導向要求的登入。這會傳回一個 Promise,在狀態從一種儲存空間複製到另一種儲存空間後,就會解析。變更持續性後,呼叫登入方式會等待持續性變更完成,再套用至新的驗證狀態。
網路瀏覽器和 React Native 應用程式的預設值為 local (前提是瀏覽器支援此儲存機制,例如 已啟用第三方 Cookie/資料),而 Node.js 後端應用程式則為 none。
持續性行為總覽
判斷目前的持續性狀態時,會套用下列條件。
- SDK 一開始會檢查是否有已驗證的使用者。除非呼叫
setPersistence,否則該使用者目前的持續性類型將套用至日後的登入嘗試。因此,如果該使用者在先前的網頁上保留在session中,並造訪了新頁面,則以其他使用者身分再次登入會導致該使用者的狀態也以session持續性儲存。 - 如果沒有使用者登入,且未指定持續性,系統會套用預設設定 (瀏覽器應用程式中的
local)。 - 如果沒有使用者登入,且設定了新的持續性類型,則日後任何登入嘗試都會使用該持續性類型。
- 如果使用者已登入,且持續性類型已修改,則該現有登入使用者的持續性會變更為新的持續性。日後所有登入嘗試都會使用新的持續性。
呼叫 signInWithRedirect 時,系統會保留目前的持續性類型,並在 OAuth 流程結束時套用至新登入的使用者,即使持續性為
none也一樣。如果該頁面明確指定持久性,則會覆寫從啟動重新導向流程的前一個頁面保留的驗證狀態持久性。Web
import { getAuth, setPersistence, signInWithRedirect, inMemoryPersistence, GoogleAuthProvider } from "firebase/auth"; const auth = getAuth(); setPersistence(auth, inMemoryPersistence) .then(() => { const provider = new GoogleAuthProvider(); // In memory persistence will be applied to the signed in Google user // even though the persistence was set to 'none' and a page redirect // occurred. return signInWithRedirect(auth, provider); }) .catch((error) => { // Handle Errors here. const errorCode = error.code; const errorMessage = error.message; });
Web
firebase.auth().setPersistence(firebase.auth.Auth.Persistence.NONE) .then(() => { var provider = new firebase.auth.GoogleAuthProvider(); // In memory persistence will be applied to the signed in Google user // even though the persistence was set to 'none' and a page redirect // occurred. return firebase.auth().signInWithRedirect(provider); }) .catch((error) => { // Handle Errors here. var errorCode = error.code; var errorMessage = error.message; });
瀏覽器分頁的預期行為
在不同分頁使用不同持續性類型時,預期行為如下。這項要求是指在任何情況下,都不應同時存在多種儲存狀態 (例如,驗證狀態儲存在 session 和 local 類型的儲存空間中):
- 使用者可以透過
session或none持續性,在多個分頁上以不同使用者身分登入。每個分頁都無法查看其他分頁的狀態。 - 系統會偵測任何使用
local持續性登入的嘗試,並在所有分頁中同步處理。如果使用者先前使用session或none持續性登入特定分頁,系統會清除該狀態。 - 如果使用者先前使用
local持續性登入,並開啟多個分頁,然後在其中一個分頁切換至none或session持續性,則該分頁的狀態會修改為使用者在session或none中持續登入,而在所有其他分頁中,使用者會登出。