Workload Identity 連携を使用してリモート エージェントを認証する

以下でサポートされています。

このドキュメントでは、Workload Identity 連携(WIF)を使用して Google SecOps リモート エージェントのキーレス認証を構成する方法について説明します。Workload Identity 連携を使用すると、リモート エージェント ホスト環境で有効期間の長いサービス アカウントの JSON キーファイルをダウンロード、管理、保存する必要がなくなります。

Workload Identity 連携を使用すると、外部クラウド プロバイダ、オンプレミス インフラストラクチャ、Kubernetes クラスタ、CI / CD パイプラインで実行されているリモート エージェントは、外部 ID プロバイダから派生した有効期間の短いフェデレーション Google Cloud アクセス トークンを使用します。

始める前に

Workload Identity 連携を構成する前に、次の前提条件を確認してください。

  • リモート エージェントの最小バージョン 2.6.2 以降。
  • Workload Identity 連携を構成するユーザーには、Workload Identity プール(roles/iam.workloadIdentityPoolAdmin)とサービス アカウント(roles/iam.serviceAccountAdmin)を作成して管理するために必要な IAM 権限が Google Cloud に付与されている必要があります。
  • Google Cloud で作成された、Chronicle SOAR リモート エージェント ロール(roles/chronicle.soarRemoteAgent)を持つ専用のサービス アカウント。サービス アカウントを作成する手順については、サービス アカウントを作成するをご覧ください。
  • 外部 ID プロバイダ(AWS、Azure、Active Directory / ADFS、Kubernetes、CI / CD パイプライン、X.509 CA、カスタム OIDC / SAML プロバイダ)へのアクセス。
  • ファイアウォールは、リモート エージェント ホストから sts.googleapis.com、iamcredentials.googleapis.com、Chronicle API ロケーション エンドポイント(ONE_PLATFORM_URL_DOMAIN で構成された REGION-chronicle.googleapis.com)へのアウトバウンド HTTPS(TCP ポート 443)トラフィックを許可する必要があります。許可リストと Private Service Connect の詳細については、ネットワークと Private Service Connect の要件とネットワークとファイアウォールの要件をご覧ください。

ステップ 1: Workload Identity プールとプロバイダを作成する

Google Cloudでは、Workload Identity プールが外部 ID を管理し、Workload Identity プロバイダが外部 IdP と Google Cloud間の接続パラメータを定義します。

  1. Google Cloud コンソールで、[Workload Identity プール] ページに移動します。[Workload Identity プール] に移動
  2. [プールを作成] をクリックします。
  3. プールの名前と説明を入力します(例: soar-remote-agent-pool)。
  4. [続行] をクリックします。
  5. [プールにプロバイダを追加] セクションで、プロバイダの種類を選択し、プロバイダのガイドからプロバイダの接続の詳細(AWS アカウント ID、OIDC 発行者、オーディエンスなど)を入力します。
  6. [属性マッピングを構成する] セクションで、プロバイダのガイドで指定されているように、外部トークン(google.subject=assertion.sub など)のクレームを Google Cloud IAM 属性にマッピングします。
  7. [保存] をクリックします。

ステップ 2: サービス アカウントの権限借用の権限を付与する

Workload Identity プール内の外部 ID がリモート エージェント サービス アカウントの権限を借用できるようにします。

  1. Google Cloud コンソールで、[サービス アカウント] ページに移動します。
  2. リモート エージェント サービス アカウントを選択します。
  3. [アクセス権を持つプリンシパル] タブをクリックします。
  4. [アクセス権を付与] をクリックします。
  5. [新しいプリンシパル] フィールドに、Workload Identity プールに対応するプリンシパル ID を入力します。
    principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/*
  6. [ロールを選択] リストで、[Workload Identity ユーザー](roles/iam.workloadIdentityUser)を選択します。
  7. [保存] をクリックします。

ステップ 3: 外部アカウントの認証情報(agent-key.json)をダウンロードまたは生成する

リモート エージェントのホストマシンで、次のいずれかのオプションを使用して、agent-key.json という名前の外部アカウント認証情報構成ファイルを取得します。

オプション A: Google Cloud コンソールからダウンロードする(推奨)

  1. Google Cloud コンソールで、[Workload Identity プール] ページに移動します。
  2. Workload Identity プールを選択し、[アクセスを許可] をクリックします。
  3. [アクセス権を付与] パネルで、[サービス アカウントの権限借用を使用してアクセス権を付与する] を選択します。
  4. [サービス アカウントを選択] リストで、リモート エージェント サービス アカウントを選択します。
  5. [プリンシパル(サービス アカウントにアクセスできる ID)を選択する] セクションで、サービス アカウントにアクセスできる ID を指定します(属性名と値を選択するなど)。
  6. [保存] をクリックします。
  7. [アプリケーションの構成] ウィンドウで、次の操作を行います。
    • [Workload Identity プロバイダ] を選択します。
    • [OIDC ID トークン パス] フィールドに、外部トークンがマウントまたは保存されている正確なパスを入力します(Kubernetes 投影トークンの場合、これは Pod マニフェストで定義されている mountPath + path(/var/run/secrets/tokens/gcp-kms-token など)と一致する必要があります)。
    • [Format type] を [Text](未加工の JWT 文字列)に設定します。標準トークン ファイルに JSON を選択しないでください。
    • [構成をダウンロード] をクリックし、ファイルを agent-key.json として保存します(または、ダウンロードしたファイルの名前を agent-key.json に変更します)。
  8. agent-key.json ファイルをリモート エージェント ホストマシンに転送します。

オプション B: gcloud CLI を使用して生成する

gcloud iam workload-identity-pools create-cred-config コマンドを実行して、認証情報の構成ファイルを生成します。

gcloud iam workload-identity-pools create-cred-config \
    projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID \
    --service-account=SERVICE_ACCOUNT_EMAIL \
    --output-file=agent-key.json \
    --credential-source-file=/var/run/secrets/tokens/gcp-kms-token

サンプル構成ファイルのリファレンス

参考までに、生成された agent-key.json ファイルには、次のような構造が含まれています。

{
  "type": "external_account",
  "audience": "//iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID",
  "subject_token_type": "urn:ietf:params:oauth:token-type:jwt",
  "token_url": "https://sts.googleapis.com/v1/token",
  "credential_source": {
    "file": "/var/run/secrets/tokens/gcp-kms-token"
  },
  "service_account_impersonation_url": "https://iamcredentials.googleapis.com/v1/projects/-/serviceAccounts/SERVICE_ACCOUNT_EMAIL:generateAccessToken"
}

ステップ 4: Google SecOps でサービス アカウントをマッピングする

リモート エージェントをデプロイする前に、Google SecOps 内でサービス アカウントのメールアドレスを承認します。

  1. [設定] > [アクセス管理] > [グループ マッピング] に移動します。
  2. [追加] 追加 をクリックします。
  3. [Add Role] ダイアログで、[IAM Role / IdP group] フィールドにサービス アカウントの完全なメールアドレスを入力します。
  4. リモート エージェントが管理する適切な環境を選択します。
  5. [追加] をクリックします。

ステップ 5: リモート エージェント認証をデプロイまたは更新する

Podman

Podman でリモート エージェント認証を構成する手順は次のとおりです。

  1. 実行中の Podman コンテナを一覧表示します。
    podman ps
  2. エージェントのコンテナ ID を入力します。
    CONTAINER_ID
  3. 次のコマンドを使用して、認証情報構成ファイルをコンテナ内の専用パスにコピーします。

    podman cp PATH_TO_AGENT_KEY/agent-key.json CONTAINER_ID:/opt/SiemplifyAgent/agent-key.json
  4. 次のコマンドを使用して、コンテナ内の認証情報構成ファイルの所有者を変更します。

    podman exec -u 0 CONTAINER_ID chown siemplify_agent:siemplify_agent /opt/SiemplifyAgent/agent-key.json
  5. 次のコマンドを実行して変更を適用します。
    podman restart CONTAINER_ID

Docker

Docker でリモート エージェント認証を構成する手順は次のとおりです。

  1. 実行中の Docker コンテナを一覧表示します。
    docker ps
  2. エージェントのコンテナ ID を入力します。
    CONTAINER_ID
  3. 次のコマンドを使用して、認証情報構成ファイルをコンテナ内の専用パスにコピーします。

    docker cp PATH_TO_AGENT_KEY/agent-key.json CONTAINER_ID:/opt/SiemplifyAgent/agent-key.json
  4. 次のコマンドを使用して、コンテナ内の認証情報構成ファイルの所有者を変更します。

    docker exec -u 0 CONTAINER_ID chown siemplify_agent:siemplify_agent /opt/SiemplifyAgent/agent-key.json
  5. 次のコマンドを実行して変更を適用します。
    docker restart CONTAINER_ID

インストーラ

CentOS/RHEL でリモート エージェント認証を構成する手順は次のとおりです。

  1. 認証情報構成ファイルを想定されるパスに移動します。

    mv PATH_TO_AGENT_KEY/agent-key.json /opt/SiemplifyAgent/agent-key.json
  2. 次のコマンドを使用して、認証情報構成ファイルの所有者を変更します。

    chown siemplify_agent:siemplify_agent /opt/SiemplifyAgent/agent-key.json
  3. 次のコマンドを実行して、エージェント サービスを再起動します。
    supervisorctl restart siemplify_agent

さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。