透過 Apple 平台上的偵錯供應商使用 App Check

對後端服務強制執行 App Check 後，應用程式中依附於該後端服務的功能，將無法在模擬器或持續整合 (CI) 環境中執行，因為這些環境不符合有效裝置的資格。如要在開發和測試期間於這些環境中執行應用程式，您必須建立應用程式的偵錯版本，並使用App Check debug provider，而非正式版認證提供者。

在模擬器中使用偵錯服務

在模擬器中以互動方式執行應用程式時 (例如在本機開發期間)，請按照下列步驟使用偵錯服務：

  1. 在偵錯版本中，使用任何 Firebase 後端服務之前，請先建立並設定 App Check 偵錯供應商工廠：

    Swift

    let providerFactory = AppCheckDebugProviderFactory()
AppCheck.setAppCheckProviderFactory(providerFactory)

FirebaseApp.configure()

    Objective-C

    FIRAppCheckDebugProviderFactory *providerFactory =
      [[FIRAppCheckDebugProviderFactory alloc] init];
[FIRAppCheck setAppCheckProviderFactory:providerFactory];

// Use Firebase library to configure APIs
[FIRApp configure];

  2. 取得偵錯權杖：

    1. 在模擬器或測試裝置上啟動應用程式。

    2. 開啟 Xcode 控制台，然後尋找App Check偵錯權杖。 例如：

      <Warning> [AppCheckCore][I-GAC004001] App Check debug token: '123a4567-b89c-12d3-e456-789012345678'.

    3. 複製權杖 (例如 123a4567-b89c-12d3-e456-789012345678)。

  3. 向 App Check 註冊偵錯權杖：

    1. 在 Firebase 控制台中，依序前往「Security」(安全性) >「App Check」 > 「Apps」(應用程式) 分頁標籤。

    2. 找出您的應用程式，按一下三點溢位選單 ()，然後選取「管理偵錯權杖」。

    3. 按照畫面上的指示註冊偵錯權杖。

    螢幕截圖：Firebase 控制台中的「管理偵錯權杖」選單項目

向 App Check 註冊權杖後，後端服務就會接受該權杖。

這個權杖可讓您存取後端服務，不必使用有效裝置，因此請務必妥善保管。請勿將其提交至公開存放區，或在應用程式的正式版本中發布。如果註冊的權杖遭到入侵，請立即使用 Firebase 控制台中的「管理偵錯權杖」刪除權杖。

在 CI 環境中使用偵錯提供者

以下說明如何在持續整合 (CI) 環境中，使用偵錯供應器進行單元測試：

  1. 在 Firebase 控制台中建立偵錯權杖：

    1. 在 Firebase 控制台中，依序前往「Security」(安全性) >「App Check」 > 「Apps」(應用程式) 分頁標籤。

    2. 找出您的應用程式，按一下三點溢位選單 ()，然後選取「管理偵錯權杖」。

    3. 按照畫面上的指示建立新的偵錯權杖。

    這個權杖可讓您存取後端服務，不必使用有效裝置，因此請務必妥善保管。請勿將其提交至公開存放區，或在應用程式的正式版本中發布。如果註冊的權杖遭到入侵，請立即使用 Firebase 控制台中的「管理偵錯權杖」刪除權杖。

    「管理偵錯權杖」選單項目的螢幕截圖

  2. 將您剛建立的偵錯權杖新增至 CI 系統的安全金鑰儲存空間 (例如 GitHub Actions 的加密密碼或 Travis CI 的加密變數)。

  3. 如有必要，請設定 CI 系統，在 CI 環境中以環境變數的形式提供偵錯權杖。將變數命名為 APP_CHECK_DEBUG_TOKEN_FROM_CI 等名稱。

  4. 在 Xcode 中，將環境變數新增至測試架構，並將名稱設為 AppCheckDebugToken，值則設為類似 $(APP_CHECK_DEBUG_TOKEN) 的內容。

  5. 設定持續整合測試腳本，將偵錯權杖做為環境變數傳遞。例如：

    xcodebuild test -scheme YOUR_TEST_SCHEME -workspace YOUR_PROJECT.xcworkspace \
APP_CHECK_DEBUG_TOKEN=$(APP_CHECK_DEBUG_TOKEN_FROM_CI)

  6. 在偵錯版本中，使用任何 Firebase 後端服務之前，請先建立並設定 App Check 偵錯供應商工廠：

    Swift

    let providerFactory = AppCheckDebugProviderFactory()
AppCheck.setAppCheckProviderFactory(providerFactory)

FirebaseApp.configure()

    Objective-C

    FIRAppCheckDebugProviderFactory *providerFactory =
      [[FIRAppCheckDebugProviderFactory alloc] init];
[FIRAppCheck setAppCheckProviderFactory:providerFactory];

// Use Firebase library to configure APIs
[FIRApp configure];

應用程式在 CI 環境中執行時，後端服務會將傳送的權杖視為有效。