Catch up on everthing we announced at this year's Firebase Summit. Learn more

在 Apple 平台上通過調試提供程序使用 App Check

如果在為 App Check 註冊您的應用程序後,您希望在 App Check 通常不會將其歸類為有效的環境中運行您的應用程序,例如開發期間的模擬器,或從持續集成 (CI) 環境中運行您的應用程序,您可以創建使用 App Check 調試提供程序而不是真正的證明提供程序的應用程序的調試版本。

在模擬器中使用調試提供程序

要在模擬器中以交互方式運行應用程序時使用調試提供程序(例如,在開發期間),請執行以下操作:

  1. 在您的調試版本中,在使用任何 Firebase 後端服務之前,創建並設置 App Check 調試提供程序工廠:

    迅速

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

    目標-C

    FIRAppCheckDebugProviderFactory *providerFactory =
          [[FIRAppCheckDebugProviderFactory alloc] init];
    [FIRAppCheck setAppCheckProviderFactory:providerFactory];
    
    // Use Firebase library to configure APIs
    [FIRApp configure];
  2. 在 Xcode 項目(v11.0 或更新版本)中啟用調試日誌:

    1. 打開產品>方案>編輯方案
    2. 從左邊的菜單中選擇運行,然後選擇參數選項卡。
    3. 傳承啟動部分的參數,添加-FIRDebugEnabled
  3. 啟動應用程序。當 SDK 嘗試向後端發送請求時,將記錄本地調試令牌。例如:

    [Firebase/AppCheck][I-FAA001001] Firebase App Check Debug Token:
    123a4567-b89c-12d3-e456-789012345678
  4. 項目設置>應用程序檢查的火力地堡控制台部分,從您的應用程序的溢出菜單管理調試令牌。然後,註冊您在上一步中登錄的調試令牌。

    “管理調試令牌”菜單項的屏幕截圖

註冊令牌後,Firebase 後端服務將接受它為有效。

由於此令牌允許在沒有有效設備的情況下訪問您的 Firebase 資源,因此將其保密至關重要。不要將其提交到公共存儲庫,如果註冊的令牌遭到破壞,請立即在 Firebase 控制台中撤銷它。

在 CI 環境中使用調試提供程序

要在持續集成 (CI) 環境中使用調試提供程序,請執行以下操作:

  1. 項目設置>應用程序檢查的火力地堡控制台部分,從您的應用程序的溢出菜單管理調試令牌。然後,創建一個新的調試令牌。您將在下一步中需要令牌。

    由於此令牌允許在沒有有效設備的情況下訪問您的 Firebase 資源,因此將其保密至關重要。不要將其提交到公共存儲庫,如果註冊的令牌遭到破壞,請立即在 Firebase 控制台中撤銷它。

    “管理調試令牌”菜單項的屏幕截圖

  2. 添加調試令牌,你剛剛創建的CI系統的安全密鑰存儲(例如,GitHub的操作“加密機密或特拉維斯CI的加密變量)。

  3. 如有必要,配置您的 CI 系統,使您的調試令牌在 CI 環境中作為環境變量可用。命名變量類似APP_CHECK_DEBUG_TOKEN_FROM_CI

  4. 在Xcode中,一個環境變量添加到與名稱測試方案FIRAAppCheckDebugToken和類似$(APP_CHECK_DEBUG_TOKEN)作為值。

  5. 配置您的 CI 測試腳本以將調試令牌作為環境變量傳遞。例如:

    xcodebuild test -scheme YourTestScheme -workspace YourProject.xcworkspace \
    APP_CHECK_DEBUG_TOKEN=$(APP_CHECK_DEBUG_TOKEN_FROM_CI)
  6. 在您的調試版本中,在使用任何 Firebase 後端服務之前,創建並設置 App Check 調試提供程序工廠:

    迅速

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

    目標-C

    FIRAppCheckDebugProviderFactory *providerFactory =
          [[FIRAppCheckDebugProviderFactory alloc] init];
    [FIRAppCheck setAppCheckProviderFactory:providerFactory];
    
    // Use Firebase library to configure APIs
    [FIRApp configure];

當您的應用在 CI 環境中運行時,Firebase 後端服務將接受它發送的有效令牌。