開始在 Apple 平台上使用 App Check 和 reCAPTCHA Enterprise

本頁面說明如何使用 reCAPTCHA Enterprise 提供者，在 Apple 平台應用程式中設定 App Check。App Check 可確保只有您的應用程式能存取專案的後端資源。如要瞭解詳情，請參閱 App Check 總覽。

App Check 需要使用評分依據 reCAPTCHA鍵，因此使用者看不到。也就是說，reCAPTCHA Enterprise 供應商不會要求使用者隨時完成驗證問題。

如果您的用途需要 reCAPTCHA Enterprise 功能，但 App Check 未實作，或是想搭配自訂供應商使用 App Check，請參閱「實作自訂 App Check 供應商」。

1. 設定 Firebase 專案

1. 如果您尚未將 Firebase 新增至 Apple 專案，請先新增。

2. 前往 Google Cloud 控制台的「Fraud Defense」(詐欺防禦) 頁面，然後針對 reCAPTCHA Enterprise 供應商執行下列操作：

   1. 確認您位在正確的專案 (請參閱畫面頂端的專案挑選器)。

   2. 如果出現提示，請啟用 reCAPTCHA Enterprise API。

   3. 建立 iOS 類型的金鑰，並指定應用程式的軟體包 ID (例如 com.example.my_app)。

      • 請務必輸入您在 Firebase 專案中建立 Firebase Apple 應用程式時提供的軟體包 ID。軟體包 ID 值會區分大小寫。

      • 對於 App Check，每個軟體包 ID 只能對應單一 reCAPTCHA 鍵。

      如需詳細操作說明，請參閱「建立以分數為依據的 reCAPTCHA 金鑰」一文。

   4. 請記下這組金鑰。您需要在 Firebase 控制台的註冊流程中新增這項資訊。

3. 在 Firebase 控制台中，依序前往「Security」(安全性) >「App Check」。

4. 在「應用程式」分頁中，註冊 Apple 平台應用程式，以便透過 reCAPTCHA Enterprise 供應商使用 App Check。您需要提供在 Google Cloud 控制台中取得的金鑰。

5. 選用：設定權杖存留時間 (TTL)。

   在應用程式註冊設定中，為供應商核發的 App Check 權杖設定自訂存留時間 (TTL)。您可以將存留時間設為介於 30 分鐘至 7 天之間的任何值。變更這個值時，請注意下列取捨：

   • 安全性：存留時間越短，安全性就越高，因為這樣可縮短遭攔截或外洩的權杖遭到濫用的時間。
   • 效能：TTL 較短表示應用程式會更頻繁地執行認證。由於應用程式驗證程序每次執行都會增加網路要求延遲，因此存留時間較短可能會影響應用程式效能。
   • 配額和費用：TTL 較短且經常重新認證會更快耗盡配額，而且對於付費服務，可能需要支付更多費用。請參閱「配額與限制」。

   預設 TTL 為 1 小時，適用於大多數應用程式。請注意，App Check 程式庫會在存留時間 (TTL) 約一半的時間點重新整理權杖。

6. 選用：設定進階設定。

7. 按一下 [儲存]。

(選用) 調整進階設定

使用者開啟應用程式時，reCAPTCHA Enterprise 會評估主要姿勢下使用者互動的風險程度，並傳回介於 0.0 和 1.0 之間的分數，以 0.1 為單位遞增。

• 0.0 分代表互動的風險高，可能是詐欺行為。
• 1.0 分代表互動的風險低，很可能是正當活動。

App Check 可讓您設定應用程式風險門檻，以便調整對這類風險的容忍度。

在多數用途中，建議使用預設門檻值 0.5。如果您的用途需要調整，可以在 Firebase 控制台中為每個應用程式設定這個值 (依序前往「安全性」 >「App Check」)。請務必展開並查看下方設定應用程式風險門檻的重要考量。

2. 在應用程式中加入 App Check SDK

使用 Swift Package Manager (SPM) 安裝及管理 Firebase 依附元件。 如果您已使用 Firebase，請確認 Firebase 套件為 12.17.0 以上版本。

1. 在 Xcode 中開啟應用程式專案。

2. 新增 Firebase 程式庫：

   1. 依序前往「File」>「Add Packages」。

   2. 系統提示時，請新增 Firebase Apple 平台 SDK 存放區：

      https://github.com/firebase/firebase-ios-sdk
      

   3. 選取最新版 SDK (12.17.0 以上版本)。

   4. 選取 FirebaseAppCheck 程式庫。

   5. 按一下「新增套件」。Xcode 會解析並下載依附元件。

   6. 系統出現提示時，請將程式庫新增至應用程式目標。

3. 新增 reCAPTCHA Enterprise 程式庫：

   1. 依序返回「File」>「Add Packages」

   2. 系統提示時，請新增 reCAPTCHA Enterprise SDK 存放區：

      https://github.com/GoogleCloudPlatform/recaptcha-enterprise-mobile-sdk
      

   3. 選取 RecaptchaEnterprise 程式庫。

   4. 按一下「新增套件」。出現提示時，請將程式庫新增至應用程式目標。

3. 初始化 App Check

在應用程式中，您必須先初始化 App Check，才能使用任何其他 Firebase 服務。

建立 RecaptchaProviderFactory 的例項，傳遞 reCAPTCHA 金鑰，然後設定 App Check 使用該例項：

let providerFactory = RecaptchaProviderFactory(siteKey: "SITE_KEY")
AppCheck.setAppCheckProviderFactory(providerFactory)

FirebaseApp.configure()

4. 監控指標並啟用強制執行功能

在應用程式中設定 App Check 後，即可開始向使用者發布更新版應用程式。

更新後的用戶端應用程式會開始傳送 App Check 權杖，並向 Firebase 發出每項要求。不過，在App Check強制執行前，App Check不會封鎖含有無效權杖的要求。