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間の接続パラメータを定義します。
- Google Cloud コンソールで、[Workload Identity プール] ページに移動します。[Workload Identity プール] に移動
- [プールを作成] をクリックします。
- プールの名前と説明を入力します(例:
soar-remote-agent-pool)。 - [続行] をクリックします。
- [プールにプロバイダを追加] セクションで、プロバイダの種類を選択し、プロバイダのガイドからプロバイダの接続の詳細(AWS アカウント ID、OIDC 発行者、オーディエンスなど)を入力します。
- [属性マッピングを構成する] セクションで、プロバイダのガイドで指定されているように、外部トークン(
google.subject=assertion.subなど)のクレームを Google Cloud IAM 属性にマッピングします。 - [保存] をクリックします。
ステップ 2: サービス アカウントの権限借用の権限を付与する
Workload Identity プール内の外部 ID がリモート エージェント サービス アカウントの権限を借用できるようにします。
- Google Cloud コンソールで、[サービス アカウント] ページに移動します。
- リモート エージェント サービス アカウントを選択します。
- [アクセス権を持つプリンシパル] タブをクリックします。
- [アクセス権を付与] をクリックします。
- [新しいプリンシパル] フィールドに、Workload Identity プールに対応するプリンシパル ID を入力します。
principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/*
- [ロールを選択] リストで、[Workload Identity ユーザー](
roles/iam.workloadIdentityUser)を選択します。 - [保存] をクリックします。
ステップ 3: 外部アカウントの認証情報(agent-key.json)をダウンロードまたは生成する
リモート エージェントのホストマシンで、次のいずれかのオプションを使用して、agent-key.json という名前の外部アカウント認証情報構成ファイルを取得します。
オプション A: Google Cloud コンソールからダウンロードする(推奨)
- Google Cloud コンソールで、[Workload Identity プール] ページに移動します。
- Workload Identity プールを選択し、[アクセスを許可] をクリックします。
- [アクセス権を付与] パネルで、[サービス アカウントの権限借用を使用してアクセス権を付与する] を選択します。
- [サービス アカウントを選択] リストで、リモート エージェント サービス アカウントを選択します。
- [プリンシパル(サービス アカウントにアクセスできる ID)を選択する] セクションで、サービス アカウントにアクセスできる ID を指定します(属性名と値を選択するなど)。
- [保存] をクリックします。
- [アプリケーションの構成] ウィンドウで、次の操作を行います。
- [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に変更します)。
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 内でサービス アカウントのメールアドレスを承認します。
- [設定] > [アクセス管理] > [グループ マッピング] に移動します。
- [追加] 追加 をクリックします。
- [Add Role] ダイアログで、[IAM Role / IdP group] フィールドにサービス アカウントの完全なメールアドレスを入力します。
- リモート エージェントが管理する適切な環境を選択します。
- [追加] をクリックします。
ステップ 5: リモート エージェント認証をデプロイまたは更新する
Podman
Podman でリモート エージェント認証を構成する手順は次のとおりです。
-
実行中の Podman コンテナを一覧表示します。
podman ps -
エージェントのコンテナ ID を入力します。
CONTAINER_ID
-
次のコマンドを使用して、認証情報構成ファイルをコンテナ内の専用パスにコピーします。
podman cp PATH_TO_AGENT_KEY/agent-key.json CONTAINER_ID:/opt/SiemplifyAgent/agent-key.json
-
次のコマンドを使用して、コンテナ内の認証情報構成ファイルの所有者を変更します。
podman exec -u 0 CONTAINER_ID chown siemplify_agent:siemplify_agent /opt/SiemplifyAgent/agent-key.json
-
次のコマンドを実行して変更を適用します。
podman restart CONTAINER_ID
Docker
Docker でリモート エージェント認証を構成する手順は次のとおりです。
-
実行中の Docker コンテナを一覧表示します。
docker ps -
エージェントのコンテナ ID を入力します。
CONTAINER_ID
-
次のコマンドを使用して、認証情報構成ファイルをコンテナ内の専用パスにコピーします。
docker cp PATH_TO_AGENT_KEY/agent-key.json CONTAINER_ID:/opt/SiemplifyAgent/agent-key.json
-
次のコマンドを使用して、コンテナ内の認証情報構成ファイルの所有者を変更します。
docker exec -u 0 CONTAINER_ID chown siemplify_agent:siemplify_agent /opt/SiemplifyAgent/agent-key.json
-
次のコマンドを実行して変更を適用します。
docker restart CONTAINER_ID
インストーラ
CentOS/RHEL でリモート エージェント認証を構成する手順は次のとおりです。
-
認証情報構成ファイルを想定されるパスに移動します。
mv PATH_TO_AGENT_KEY/agent-key.json /opt/SiemplifyAgent/agent-key.json
-
次のコマンドを使用して、認証情報構成ファイルの所有者を変更します。
chown siemplify_agent:siemplify_agent /opt/SiemplifyAgent/agent-key.json
-
次のコマンドを実行して、エージェント サービスを再起動します。
supervisorctl restart siemplify_agent
関連ドキュメント
さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。