進階驗證功能

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 專案

  1. 使用 Google 帳戶登入 Firebase 控制台。
  2. 按一下按鈕建立新專案,然後輸入專案名稱 (例如 Authentication MFA Codelab)。
  3. 按一下「繼續」。
  4. 如果出現提示訊息,請詳閱並接受《Firebase 條款》,然後點選「繼續」。
  5. (選用) 在 Firebase 控制台啟用 AI 輔助功能 (稱為「Gemini in Firebase」)。
  6. 在本程式碼實驗室中,您不需要 Google Analytics,因此請關閉 Google Analytics 選項。
  7. 按一下「建立專案」,等待專案佈建完成,然後按一下「繼續」。

將程式碼連結至 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!

辦公室員工跳「舉手歡呼」舞的 GIF