監控 App Check 要求指標

在應用程式中加入 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」部分。例如:

    App Check 指標頁面的螢幕截圖

  • 如要查看特定 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 強制執行。