デバッグ プロバイダで App Check を使用する

App Check にアプリを登録した後で、 App Check で通常は有効と分類されない環境でアプリを実行したい場合、 開発中のシミュレータ、または継続的インテグレーション(CI)から 使用し、SDK を使用してアプリのデバッグビルドを App Attest ではなく App Check デバッグ プロバイダ。

<ph type="x-smartling-placeholder">をご覧ください。

シミュレータでデバッグ プロバイダを使用する

シミュレータでインタラクティブにアプリを実行しているときにデバッグ プロバイダを使用するには (開発中など)は、次の操作を行います。

  1. [認証情報] でプロジェクトの iOS API キーを検索します。 (API とサービス] セクションに表示されます。

  2. デバッグビルドで、デバッグ プロバイダを使用するように App Check を構成します。これから 前のステップで取得した API キーを指定する必要があります。

    #if targetEnvironment(simulator)
    GIDSignIn.sharedInstance.configureDebugProvider(withAPIKey: apiKey) { error in
      if let error {
        print("Error configuring `GIDSignIn` for App Check: \(error)")
      }
    }
    #else
    // Configure App Check for production.
    #endif
    
  3. アプリを起動します。ローカル デバッグ トークンが Xcode コンソールにログ出力されます。 SDK がバックエンドにリクエストを送信しようとします。例:

    <Warning> [AppCheckCore][I-GAC004001] App Check debug token:
    '123a4567-b89c-12d3-e456-789012345678'.
    
  4. [App Check] セクションで、 を開き、アプリのメニューから [デバッグ トークンを管理] を選択します。 オーバーフロー メニューを選択します。次に、先ほどロギングしたデバッグ トークンを登録します。 示します。

    [デバッグ トークンを管理] メニュー項目のスクリーンショット

トークンを登録すると、Google の OAuth 2.0 エンドポイントがトークンを 有効にします。

このトークンにより、トークンなしで認証エンドポイントにアクセス 非公開にすることが重要です。確約しないでください。 登録済みのトークンが不正使用された場合は、トークンを すぐに使用できます。

CI 環境でデバッグ プロバイダを使用する

継続的インテグレーション(CI)環境でデバッグ プロバイダを使用するには、次の手順を実施します。 次のとおりです。

  1. [App Check] セクションで、 を開き、アプリのメニューから [デバッグ トークンを管理] を選択します。 オーバーフロー メニューを選択します。次に、新しいデバッグ トークンを作成します。このトークンは 確認しましょう。

    このトークンを使用すると、認証なしで認証エンドポイントに 非公開にすることが重要です。確約しないでください。 登録済みのトークンが不正使用された場合は、トークンを すぐに使用できます。

    [デバッグ トークンを管理] メニュー項目のスクリーンショット

  2. 作成したデバッグ トークンを CI システムの安全なキーストアに追加します。 (たとえば、GitHub Actions の暗号化されたシークレット Travis CI の暗号化された変数など)が使用されます。

  3. 必要に応じて、デバッグ トークンを利用できるように 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. [認証情報] でプロジェクトの iOS API キーを検索します。 (API とサービス] セクションに表示されます。

  7. デバッグビルドで、デバッグ プロバイダを使用するように App Check を構成します。これから 前のステップで取得した API キーを指定する必要があります。

    #if targetEnvironment(simulator)
    GIDSignIn.sharedInstance.configureDebugProvider(withAPIKey: apiKey) { error in
      if let error {
        print("Error configuring `GIDSignIn` for App Check: \(error)")
      }
    }
    #else
    // Configure App Check for production.
    #endif
    

CI 環境でアプリを実行すると、Google の OAuth 2.0 エンドポイントが プロジェクトに有効なトークンとして送信されます。