驗證常見問題與疑難排解

使用電話驗證時，如何防止簡訊濫用？

為保護專案免受垃圾簡訊和 API 濫用行為影響，請採取下列步驟：

考慮設定簡訊區域政策

1. 查看區域簡訊用量。

   找出傳送簡訊次數非常高，但已驗證簡訊次數非常低 (或為零) 的區域。驗證成功率是驗證次數與傳送次數的比率。 由於簡訊並非保證傳遞的通訊協定，且部分地區可能會發生濫用情形，因此一般而言，70% 至 85% 的成功率都算正常。如果成功率低於 50%，表示系統傳送了許多簡訊，但登入成功次數很少，這通常是惡意行為者和簡訊流量灌水活動的指標。

2. 使用「簡訊區域政策」拒絕成功率低的簡訊區域，或只允許特定區域 (如果應用程式僅適用於特定市場)。

限制授權驗證網域

使用驗證設定資訊主頁管理授權網域。系統預設會將 localhost 網域新增至核准的驗證網域，以簡化開發作業。請考慮從正式版專案的授權網域中移除 localhost，以免惡意行為人透過自己的 localhost 存取正式版專案。

啟用並強制執行 App Check

啟用 App Check，確保要求只來自與專案相關聯的應用程式，有助於保護專案免於 API 濫用。

如要搭配 Firebase Authentication 使用 App Check，請升級至 Firebase Authentication with Identity Platform。

請注意，您必須在Firebase管理中心中強制執行 App Check，才能使用 Authentication (建議先監控流量，再強制執行)。此外，請仔細檢查 reCAPTCHA Enterprise 核准的網站清單，確認其中只包含正式版網站，並確認 App Check 中向專案註冊的應用程式清單正確無誤。

請注意，App Check 會判斷呼叫是否來自您註冊的應用程式，藉此防範自動化攻擊。但使用者仍可透過非預期方式使用您的應用程式 (例如啟動登入流程，但從未完成，藉此產生傳送的簡訊)。

電話號碼是否已轉移至電話驗證支援的新電信業者？

目前，如果使用者將號碼從一家電信業者轉移到另一家，所有簡訊都將無法傳送給這些使用者。目前沒有解決方法，Firebase 正在處理這個問題。

在我的 Android 應用程式中，為什麼會收到以下錯誤訊息：
Google sign in failed？

如果收到下列錯誤訊息，請按照本常見問題中的疑難排解步驟操作：

GoogleFragment: Google sign in failed
    com.google.android.gms.common.api.ApiException: 13: Unable to get token.
        at
com.google.android.gms.internal.auth-api.zbay.getSignInCredentialFromIntent(com.google.android.gms:play-services-auth@@20.3.0:6)

1. 確認已正確啟用 Google 登入做為驗證供應商：

   1. 在 Firebase 控制台中，開啟「Authentication」部分。

   2. 在「登入方式」分頁中，停用並重新啟用「Google」登入方式 (即使已啟用)：

      1. 開啟「Google」登入方式，停用該方式，然後按一下「儲存」。

      2. 重新開啟「Google」登入方式，啟用該方式，然後按一下「儲存」。

2. 請確認應用程式使用的是最新版 Firebase 設定檔 (google-services.json)。
   取得應用程式的設定檔。

3. 確認是否仍會收到錯誤訊息。如果是，請繼續下一個疑難排解步驟。

4. 確認已提供必要的基礎 OAuth 2.0 用戶端。

   1. 在 Google Cloud 控制台的「憑證」頁面中，查看「OAuth 2.0 用戶端 ID」部分。

   2. 如果沒有 OAuth 2.0 用戶端 (且您已完成上述所有疑難排解步驟)，請與支援團隊聯絡。

在我的 Apple 平台應用程式中，為什麼會收到下列錯誤訊息：
You must specify <clientID> in <GIDConfiguration>？

如果收到下列錯誤訊息，請按照本常見問題中的疑難排解步驟操作：

You must specify |clientID| in |GIDConfiguration|

1. 確認已正確啟用 Google 登入做為驗證供應商：

   1. 在 Firebase 控制台中，開啟「Authentication」部分。

   2. 在「登入方式」分頁中，停用並重新啟用「Google」登入方式 (即使已啟用)：

      1. 開啟「Google」登入方式，停用該方式，然後按一下「儲存」。

      2. 重新開啟「Google」登入方式，啟用該方式，然後按一下「儲存」。

2. 請確認應用程式使用的是最新版 Firebase 設定檔 (GoogleService-Info.plist)。
   取得應用程式的設定檔。

3. 確認是否仍會收到錯誤訊息。如果是，請繼續下一個疑難排解步驟。

4. 確認已提供必要的基礎 OAuth 2.0 用戶端。

   1. 在 Google Cloud 控制台的「憑證」頁面中，查看「OAuth 2.0 用戶端 ID」部分。

   2. 如果沒有 OAuth 2.0 用戶端 (且您已完成上述所有疑難排解步驟)，請與支援團隊聯絡。

為什麼我在網頁應用程式中會收到下列錯誤：
AuthErrorCode.INVALID_OAUTH_CLIENT_ID？

如果收到下列錯誤訊息，請按照本常見問題中的疑難排解步驟操作：

AuthErrorCode.INVALID_OAUTH_CLIENT_ID

1. 確認已正確啟用 Google 登入做為驗證供應商：

   1. 在 Firebase 控制台中，開啟「Authentication」部分。

   2. 在「登入方式」分頁中，停用並重新啟用「Google」登入方式 (即使已啟用)：

      1. 開啟「Google」登入方式，停用該方式，然後按一下「儲存」。

      2. 重新開啟「Google」登入方式，啟用該方式，然後按一下「儲存」。

2. 此外，在「Authentication」部分「Google」登入供應商設定中，請確認 OAuth 用戶端 ID 和密鑰與 Google Cloud 控制台「憑證」頁面顯示的網頁用戶端相符 (請查看「OAuth 2.0 用戶端 ID」部分)。

在我的網頁應用程式中，為什麼使用重新導向登入會失敗，並顯示以下錯誤：
This domain YOUR_REDIRECT_DOMAIN is not authorized to run this operation？

如果收到下列錯誤訊息，請按照本常見問題中的疑難排解步驟操作：

This domain YOUR_REDIRECT_DOMAIN is not authorized to run this operation.

如果您的重新導向網域未列為 Firebase Authentication 的授權網域，或是您搭配 Firebase Authentication 服務使用的 API 金鑰無效，就很有可能發生這個錯誤。

首先，請確認 YOUR_REDIRECT_DOMAIN 已列入 Firebase 專案的授權網域清單。如果重新導向網域已列於該處，請繼續排解 API 金鑰無效的問題。

根據預設，Firebase Authentication JS SDK 會依賴 Firebase 專案中標示為 Browser key 的 API 金鑰，並使用這個金鑰驗證登入重新導向網址是否有效 (根據授權網域清單)。Authentication 會根據您存取 Authentication SDK 的方式取得這個 API 金鑰：

• 如果您使用Hosting提供的 Auth 輔助程式，透過 Authentication JS SDK 登入使用者，則每次部署至 Firebase Hosting 時，Firebase 會自動取得 API 金鑰和其餘 Firebase 設定。請確認authDomain網頁應用程式firebaseConfig已正確設定，可使用該 Hosting 網站的其中一個網域。如要確認，請前往 https://authDomain__/firebase/init.json，並檢查 projectId 是否與 firebaseConfig 中的相符。

• 如果您自行代管登入程式碼，可以使用 __/firebase/init.json 檔案，將 Firebase 設定提供給自行代管的 Authentication JS SDK 重新導向輔助程式。API 金鑰和這個設定檔中列出的 projectId 應與網頁應用程式 firebaseConfig 相符。

確認 API 金鑰未遭刪除：前往 Google Cloud 控制台的「APIs & Services」(API 和服務) >「Credentials」(憑證) 面板，即可查看專案的所有 API 金鑰。

• 如果 Browser key「尚未」刪除，請檢查下列事項：

  • 確認 Firebase Authentication API 位於金鑰可存取的允許 API 清單中 (進一步瞭解 API 金鑰的 API 限制)。

  • 如果您自行代管登入程式碼，請確認 __/firebase/init.json 檔案中列出的 API 金鑰與 Google Cloud 控制台中的 API 金鑰相符。視需要修正檔案中的金鑰，然後重新部署應用程式。

  • 如果 Browser key 已遭刪除，您可以讓 Firebase 為您產生新的 API 金鑰：在 Firebase 控制台中，依序前往「settings」>「專案設定」，然後在「您的應用程式」部分中，按一下您的網頁應用程式。這項操作會自動建立 API 金鑰，您可以在網頁應用程式的「SDK 設定和設定」部分中查看。

  請注意，在 Google Cloud 控制台中，這個新 API 金鑰不會稱為 Browser key，而是與 Firebase 網頁應用程式的暱稱相同。如果您決定對這個新 API 金鑰新增 API 限制，請務必將 Firebase Authentication API 加入允許的 API 清單。

  建立新的 API 金鑰後，請完成下列適用步驟：

  • 如果您使用保留的 Hosting 網址，請將應用程式重新部署至 Firebase，以便自動取得新的 API 金鑰和其餘 Firebase 設定。

  • 如果您自行代管登入程式碼，請複製新的 API 金鑰並加進 __/firebase/init.json 檔案，然後重新部署應用程式。

如何手動建構 OAuth 網路用戶端？

1. 開啟 Google Cloud 控制台的「憑證」頁面。

2. 在頁面頂端，選取「建立憑證」>「OAuth 用戶端 ID」。

3. 如果系統提示您設定同意畫面，請按照畫面上的指示操作，然後繼續執行本常見問題的後續步驟。

4. 建立 OAuth 網頁用戶端：

   1. 在「Application Type」部分，選取「網頁應用程式」。

   2. 在「已授權的 JavaScript 來源」部分，新增下列項目：

      • http://localhost
      • http://localhost:5000
      • https://PROJECT_ID.firebaseapp.com
      • https://PROJECT_ID.web.app

   3. 針對「已授權的重新導向 URI」，請新增下列項目：

      • https://PROJECT_ID.firebaseapp.com/__/auth/handler
      • https://PROJECT_ID.web.app/__/auth/handler

   4. 儲存 OAuth 用戶端。

5. 將新的 OAuth 用戶端 ID 和用戶端密鑰複製到剪貼簿。

6. 在 Firebase 控制台中，開啟「Authentication」部分。

7. 在「登入方式」分頁中，開啟「Google 登入」供應商，然後貼上您剛從 Google Cloud 控制台建構及複製的網路伺服器用戶端 ID 和密鑰。然後點選「儲存」。

使用者以電子郵件地址和密碼註冊帳戶時，系統如何為可傳送給使用者的確認電子郵件，決定電子郵件範本的 %APP_NAME%？

2022 年 12 月前，每當在 Firebase 專案中註冊 Android 應用程式時，系統會自動佈建 OAuth 品牌名稱，並填入電子郵件範本中的 %APP_NAME%。現在，只有在啟用 Google 登入時，才會佈建 OAuth 品牌，因此 %APP_NAME% 的判斷方式如下：

• 如果 OAuth 品牌名稱可用，電子郵件範本中的 %APP_NAME% 就會是 OAuth 品牌名稱 (與 2022 年 12 月前的行為相同)。

• 如果 OAuth 品牌名稱無法使用，系統會依下列方式判斷電子郵件範本中的 %APP_NAME%：

  • 網頁應用程式的 %APP_NAME% 會是預設 Firebase Hosting 網站名稱 (.firebaseapp.com 和 .web.app 前面的值，通常是 Firebase 專案 ID)。

  • 行動應用程式：

    • 如果要求中包含 Android 套件名稱或 iOS 軟體包 ID，則 %APP_NAME% 會是 Play 商店或 App Store 中使用的應用程式名稱 (分別)。

    • 否則 %APP_NAME% 會是預設Firebase Hosting網站名稱 (.firebaseapp.com 和 .web.app 前面的值，通常是 Firebase 專案 ID)。

  請注意，如果預設 Firebase Hosting 網站名稱的查詢失敗，最終備用方案是使用 Firebase 專案 ID 做為 %APP_NAME%。