1. 設定
取得原始碼
在本程式碼實驗室中,您會從幾乎完成的 Friendly Chat 範例應用程式版本開始,因此首先需要複製原始碼:
$ git clone https://github.com/firebase/codelab-friendlychat-web --branch security
接著,移至 security-start 目錄,您將在這個目錄中完成本程式碼實驗室的其餘部分:
$ cd codelab-friendlychat-web/security-start
現在,請安裝依附元件,以便執行程式碼。如果網際網路連線速度較慢,可能需要一兩分鐘:
$ npm install && (cd functions && npm install)
瞭解這個存放區
security-solution/ 目錄包含範例應用程式的完整程式碼。security-start 目錄是您在程式碼實驗室中要使用的目錄,缺少驗證實作的幾個重要部分。security-start/ 和 security-solution/ 中的主要檔案和功能如下:
functions/index.js包含 Cloud Functions 程式碼,您將在這裡編寫驗證封鎖函式。public/- 包含 Chat 擴充應用程式的靜態檔案public/scripts/main.js:即時通訊應用程式 JS 程式碼 (src/index.js) 的編譯位置src/firebase-config.js:包含用於初始化即時通訊應用程式的 Firebase 設定物件src/index.js:Chat 應用程式 JS 程式碼
取得 Firebase CLI
Emulator Suite 是 Firebase CLI (指令列介面) 的一部分,您可以使用下列指令,在機器上安裝 Emulator Suite:
$ npm install -g firebase-tools@latest
使用 webpack 建構 JavaScript,這會在 public/scripts/ 目錄中建立 main.js。
webpack build
接著,確認您使用的是最新版 CLI。本程式碼實驗室適用於 11.14 以上版本。
$ firebase --version 11.14.2
連結至 Firebase 專案
建立新的 Firebase 專案
- 使用 Google 帳戶登入 Firebase 控制台。
- 按一下按鈕建立新專案,然後輸入專案名稱 (例如
Authentication MFA Codelab)。
- 按一下「繼續」。
- 如果出現提示訊息,請詳閱並接受《Firebase 條款》,然後點選「繼續」。
- (選用) 在 Firebase 控制台啟用 AI 輔助功能 (稱為「Gemini in Firebase」)。
- 在本程式碼實驗室中,您不需要 Google Analytics,因此請關閉 Google Analytics 選項。
- 按一下「建立專案」,等待專案佈建完成,然後按一下「繼續」。
將程式碼連結至 Firebase 專案
現在,您需要將這段程式碼連結至 Firebase 專案。首先,執行下列指令,登入 Firebase CLI:
$ firebase login
接著執行下列指令,建立專案別名。將 $YOUR_PROJECT_ID 替換為 Firebase 專案 ID。
$ firebase use $YOUR_PROJECT_ID
現在可以執行應用程式了!
2. 執行模擬器
在本節中,您將在本機執行應用程式。這表示該啟動模擬器套件了。
啟動模擬器
在程式碼實驗室來源目錄中,執行下列指令啟動模擬器:
$ firebase emulators:start
這項操作會在 http://127.0.0.1:5170 提供應用程式,並在您變更原始碼時持續重新建構。只要在瀏覽器中強制重新整理 (Ctrl + Shift + R),就能看到變更。
輸出內容應大致如下:
i emulators: Starting emulators: auth, functions, firestore, hosting, storage ✔ functions: Using node@16 from host. i firestore: Firestore Emulator logging to firestore-debug.log ✔ firestore: Firestore Emulator UI websocket is running on 9150. i hosting[demo-example]: Serving hosting files from: ./public ✔ hosting[demo-example]: Local server: http://127.0.0.1:5170 i ui: Emulator UI logging to ui-debug.log i functions: Watching "[...]" for Cloud Functions... ✔ functions: Loaded functions definitions from source: beforecreated. ✔ functions[us-central1-beforecreated]: providers/cloud.auth/eventTypes/user.beforeCreate function initialized (http://127.0.0.1:5011/[...]/us-central1/beforecreated). i Running script: npm start > security@1.0.0 start > webpack --watch --progress [...] webpack 5.50.0 compiled with 1 warning in 990 ms
看到「All emulators ready」訊息後,即可使用應用程式。
3. 實作多重驗證
這個存放區已部分實作多重驗證。您將新增程式碼,先為使用者註冊多重驗證,然後提示已註冊多重驗證的使用者提供第二驗證因素。
在編輯器中開啟 src/index.js 檔案,並找出 startEnrollMultiFactor() 方法。新增下列程式碼,設定 reCAPTCHA 驗證工具,防止電話濫用行為 (reCAPTCHA 驗證工具會設為隱形,使用者不會看到):
async function startEnrollMultiFactor(phoneNumber) {
const recaptchaVerifier = new RecaptchaVerifier(
"recaptcha",
{ size: "invisible" },
getAuth()
);
接著,找出 finishEnrollMultiFactor() 方法,並新增下列程式碼來註冊第二個驗證方法:
// Completes MFA enrollment once a verification code is obtained.
async function finishEnrollMultiFactor(verificationCode) {
// Ask user for the verification code. Then:
const cred = PhoneAuthProvider.credential(verificationId, verificationCode);
const multiFactorAssertion = PhoneMultiFactorGenerator.assertion(cred);
// Complete enrollment.
await multiFactor(getAuth().currentUser)
.enroll(multiFactorAssertion)
.catch(function (error) {
alert(`Error finishing second factor enrollment. ${error}`);
throw error;
});
verificationId = null;
}
接著,找出 signIn 函式,並新增下列控制流程,提示已註冊多重驗證的使用者輸入第二驗證因素:
async function signIn() {
// Sign in Firebase using popup auth and Google as the identity provider.
var provider = new GoogleAuthProvider();
await signInWithPopup(getAuth(), provider)
.then(function (userCredential) {
// User successfully signed in and is not enrolled with a second factor.
})
.catch(function (error) {
if (error.code == "auth/multi-factor-auth-required") {
multiFactorResolver = getMultiFactorResolver(getAuth(), error);
displaySecondFactor(multiFactorResolver.hints);
} else {
alert(`Error signing in user. ${error}`);
}
});
}
其餘實作項目 (包括這裡叫用的函式) 均已完成。如要瞭解其運作方式,請瀏覽檔案的其餘部分。
4. 在模擬器中試用多重驗證登入功能
現在,請試試看 MFA 實作!確認模擬器仍在執行,並前往 localhost:5170 存取本機託管的應用程式。嘗試登入,系統提示您提供 MFA 驗證碼時,您會在終端機視窗中看到該驗證碼。
模擬器完全支援多重驗證,因此開發環境可以完全獨立。
如要進一步瞭解如何實作多重驗證,請參閱參考文件。
5. 建立封鎖函式
部分應用程式僅供特定使用者群組使用。在這種情況下,您需要為使用者註冊或登入應用程式建立自訂要求。
這就是封鎖函式的作用:建立自訂驗證需求。這些函式屬於 Cloud Functions,但與大多數函式不同,會在使用者嘗試註冊或登入時同步執行。
如要建立封鎖函式,請在編輯器中開啟 functions/index.js,並找出已註解排除的 beforecreated 函式。
替換成以下程式碼,只允許網域為 example.com 的使用者建立帳戶:
exports.beforecreated = beforeUserCreated((event) => {
const user = event.data;
// Only users of a specific domain can sign up.
if (!user.email || !user.email.endsWith("@example.com")) {
throw new HttpsError("invalid-argument", "Unauthorized email");
}
});
6. 在模擬器中試用封鎖函式
如要試用封鎖函式,請確認模擬器正在執行,並在網頁應用程式 (localhost:5170) 登出。
接著,請嘗試使用結尾不是 example.com 的電子郵件地址建立帳戶。封鎖函式會阻止作業成功。
現在,請改用結尾為 example.com 的電子郵件地址再試一次。帳戶會成功建立。
您可以使用封鎖函式,建立任何所需的驗證限制。詳情請參閱參考文件。
重點回顧
做得好!您在網頁應用程式中新增多重驗證機制,協助使用者保護帳戶安全,並建立自訂要求,讓使用者透過封鎖函式註冊。你絕對值得獲得 GIF!
