IAM のロールと権限

このドキュメントでは、Workload Manager 評価を使用することと、評価を実行するための Workload Manager サービス アカウントを自動的に作成するために、さまざまなプロジェクトで必要なロールと権限について説明します。

Workload Manager プロジェクト

Workload Manager の評価では、複数のプロジェクト(ターゲット プロジェクト)のリソースがスキャンされますが、評価はコンシューマ プロジェクトと呼ばれる 1 つのプロジェクトにのみ保存されます。

コンシューマ プロジェクトを使用して、Google Cloud コンソールで Workload Manager にアクセスし、評価を作成して実行します。 Google Cloud コンソールを使用して評価を作成する場合は、ワークフローの [評価スコープ] セクションで、評価するリソースを保持するターゲット プロジェクトを指定します。

評価するリソースが Workload Manager 評価を作成するプロジェクトと同じプロジェクトにある場合、コンシューマ プロジェクトもターゲット プロジェクトの 1 つと見なされます。

評価の作成と実行に必要な権限の概要

次の表に、Workload Manager を使用して評価を作成して実行するために、コンシューマ プロジェクトとターゲット プロジェクトのユーザーに必要な権限を示します。必要な権限を取得するには、必要な権限を含むロールを付与するよう管理者に依頼するか、カスタムロールを作成します。

アクション コンシューマー プロジェクト ターゲット プロジェクト
Workload Manager API を有効にする 権限:
serviceusage.services.enable

権限を含む事前定義ロール:
roles/serviceusage.serviceUsageAdmin
なし
評価を作成 1. サービス アカウントを作成する権限:
resourcemanager.projects.setIamPolicy

権限を含む事前定義ロール:
roles/resourcemanager.projectIamAdmin

最初の評価を作成する場合にのみ必要です。

2. 評価の作成権限を付与する事前定義ロール:
roles/workloadmanager.evaluationAdmin

サービス アカウントを作成する権限:
resourcemanager.projects.setIamPolicy

権限を含む事前定義ロール:
roles/resourcemanager.projectIamAdmin

最初の評価を作成する場合にのみ必要です。

評価を実行する 権限:
workloadmanager.evaluations.run

権限を含む事前定義ロール:
roles/workloadmanager.evaluationAdmin

なし

評価の結果を表示する 権限:
workloadmanager.results.list


roles/workloadmanager.evaluationAdmin

roles/workloadmanager.evaluationViewer
なし

Workload Manager サービス エージェント

Workload Manager は、サービス エージェントを使用して、リソースと関連プロジェクト間のアクセスと通信を制御します。

Google Cloud console または Workload Manager API を使用してワークロードを評価できます。 Google Cloud consoleを使用すると、Workload Manager は必要なすべてのサービス エージェントを自動的に作成します。Workload Manager API を使用する場合は、サービス エージェントを手動で作成する必要があります。

必要なロール

サービス エージェントの作成に必要な権限を取得するには、スコープ内の各ターゲット プロジェクトに対するプロジェクト IAM 管理者 roles/resourcemanager.projectIamAdmin)IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

この事前定義ロールには、サービス エージェントを作成するために必要な resourcemanager.projects.setIamPolicy 権限が含まれています。

カスタムロールや他の事前定義ロールを使用して、この権限を取得することもできます。

ロールを作成してサービス エージェントに付与する

Google Cloud コンソール

Google Cloud console を使用してワークロードを評価すると、Workload Manager はコンシューマ プロジェクトにサービス エージェントを自動的に作成します。

このサービス エージェントのメールアドレスは service-PROJECT_NUMBER@gcp-sa-workloadmanager.iam.gserviceaccount.com で、Workload Manager サービス アカウントと呼ばれます。

Workload Manager サービス エージェントが評価を実行するには、次のロールが必要です。プロンプトが表示されたら、これらのロールをサービス エージェントに付与します。

  • Workload Manager サービス エージェント(roles/workloadmanager.serviceAgent): 移行先のプロジェクトで必要です。
  • Workload Manager ワーカー(roles/workloadmanager.worker): 評価の頻度を設定した場合にのみ、コンシューマ プロジェクトで必要です。

Workload Manager API

Workload Manager API を使用してワークロードを評価する場合は、評価を作成する前に、コンシューマ プロジェクトに Workload Manager サービス エージェントを手動で作成する必要があります。サービス エージェントを作成するには、gcloud beta services identity create コマンドを使用します。

  gcloud beta services identity create --service=workloadmanager.googleapis.com  \
      --project=PROJECT_NUMBER

PROJECT_NUMBER は、サービス エージェントを作成するコンシューマ プロジェクトの数値 ID に置き換えます。

サービス エージェントを作成したら、サービス エージェントに次のロールを付与する必要があります。

  • Workload Manager サービス エージェント(roles/workloadmanager.serviceAgent): 移行先のプロジェクトで必要です。
  • Workload Manager ワーカー(roles/workloadmanager.worker): 評価の頻度を設定した場合にのみ、コンシューマ プロジェクトで必要です。

詳細については、サービス エージェントにロールを付与するをご覧ください。

Workload Manager のその他のロール

Workload Manager の評価とリソースへのアクセスをさらに制御するには、ユーザーに追加の Workload Manager ロールが必要です。

詳細については、Workload Manager: IAM によるアクセス制御をご覧ください。

次のステップ