在應用程式中加入 App Check 程式庫後,請先確認啟用 App Check 強制執行功能不會干擾現有的合法使用者,再啟用這項功能。
App Check 要求指標是做出這項決策的重要工具。您可以在 Google API 控制台或 Firebase 控制台監控 App Check 指標。
在 Google API 控制台中監控指標
如要查看 iOS OAuth 用戶端的指標,請前往「Credentials」(憑證) 頁面,切換至用戶端的編輯畫面。在頁面右側的「Google Identity for iOS」部分下方,您會看到相關指標。這些指標會顯示 App Check 要求指標。指標包含下列資訊:
- 已驗證的要求數量:具備有效 App Check 權杖的要求。啟用 App Check 強制執行功能後,只有這類要求會成功。
- 未經驗證的要求數量:可能為過時的用戶端要求 - 缺少 App Check 權杖的要求。這些要求可能來自未導入 App Check 的舊版應用程式。
- 未經驗證的要求數量:來源未知的要求 - 缺少 App Check 權杖的要求,且看起來並非來自您的應用程式。
- 未經驗證的要求數量:無效要求 - 具備無效 App Check 權杖的要求,可能來自模擬環境,或是試圖冒用您應用程式的偽造用戶端。
在 Firebase 控制台監控指標
您可以查看專案整體或個別 OAuth 用戶端的指標:
如要查看專案的 App Check 要求指標,請開啟 Firebase 控制台的「App Check」部分,然後展開「Google Identity for iOS」部分。例如:

如要查看特定 OAuth 用戶端的 App Check 要求指標,請開啟 Firebase 控制台的「OAuth clients」(OAuth 用戶端) 頁面,然後展開該用戶端對應的部分。
要求指標分為四個類別:
「已驗證」要求是指具備有效 App Check 權杖的要求。啟用 App Check 強制執行功能後,只有這類要求會成功。
過時用戶端要求是指缺少 App Check 權杖的要求。這類要求可能來自應用程式尚未採用 App Check 時,所用的舊版 Firebase SDK。
「來源不明」要求是指缺少 App Check 權杖,且看起來並非來自 Firebase SDK 的要求。這些要求可能來自遭竊的 API 金鑰,或是不使用 Firebase SDK 的偽造要求。
「無效」要求是指 App Check 權杖無效的要求,可能來自模擬環境,或是試圖冒用您應用程式的偽造用戶端。
應用程式的這些類別分布情形,應做為您決定何時啟用強制執行的依據。以下提供一些準則:
如果近期要求幾乎都來自已驗證的用戶端,建議啟用強制執行功能,開始保護驗證端點。
如果近期要求有很大一部分來自可能過時的用戶端,為避免干擾使用者,建議您先等待更多使用者更新應用程式,再啟用強制執行。如果對已發布的應用程式強制執行 App Check,未整合 App Check SDK 的舊版應用程式將無法運作。
如果應用程式尚未推出,請立即啟用 App Check 強制執行功能,因為目前沒有任何過時的用戶端在使用中。
後續步驟
瞭解 App Check 對使用者的影響,並準備好繼續操作後,即可啟用 App Check 強制執行。