統合アクセス ポリシー(UAP)を使用すると、Google Cloud リソースへのアクセスを許可または拒否できます。許可ポリシーや拒否ポリシーとは異なり、UAP では同じポリシーでアクセスを許可または拒否できるため、ポリシー管理を簡素化できます。UAP は再利用可能であるため、同じ UAP を複数のリソースに適用できます。
統合アクセス ポリシーの仕組み
IAM でアクセスを許可または拒否するには、誰がどのリソースに対して何を行うことを許可または拒否するかを指定する必要があります。
UAP では、UAP ルールを作成して、誰が何を実行できるか、または 実行できないかを指定します。各ルールには、一連のプリンシパル、一連のロールと権限、効果がリストされます。効果(許可または拒否)は、リストに記載されているプリンシパルにルールのロールと権限を付与するか、ルールの権限の使用を禁止するかを指定します。1 つの UAP に最大 100 個のルールを設定できます。
UAP がアクセスを制御するリソースを指定するには、UAP バインディングを使用して UAP をリソースにバインドします。1 つの UAP を最大 5 つのリソースにバインドできます。1 つのリソースに最大 5 つのポリシーをバインドできます。
ユースケース
IAM には、アクセスの許可と拒否に使用できるポリシータイプが複数あります。
すでに許可ポリシーまたは拒否ポリシーを使用してアクセスを制御している場合は、引き続きそれらのポリシーを使用することをおすすめします。これらのポリシータイプは Policy Troubleshooter でもサポートされているため、アクセスエラーの根本原因を簡単に把握できます。
UAP は次の状況で使用します。
- 新しい組織を設定し、UAP を使用して組織全体のアクセスを制御する予定である。
- UAP 条件を使用してきめ細かいアクセス制御を設定する。
統合アクセス ポリシーのルール
UAP は、許可ルールと拒否ルールで構成されます。これらのルールには、次のコンポーネントが含まれています。
効果: ルールがアクセスを許可するか、アクセスを拒否するか。アクセスを許可するルールは、許可ルールと呼ばれます。アクセスを拒否するルールは、拒否ルールと呼ばれます。
プリンシパルのセット: ルールに含めるプリンシパル(ユーザー、グループ、サービス アカウントなど)。許可ルールでは、これらのプリンシパルにアクセス権が付与されます。拒否ルールでは、これらのプリンシパルはアクセスを拒否されます。
ロールと権限のリスト: ルールに含めるロールと権限。許可ルールでは、これらの権限が付与されます。拒否ルールでは、これらの権限は拒否されます。
省略可: 条件式: ルールを適用するために true にする必要がある条件を指定する IAM 条件式。詳細については、このページの UAP の条件をご覧ください。
統合アクセス ポリシー ルールのプリンシパル
ルールに含めるプリンシパルを指定するには、次のように定義します。
- 含まれるプリンシパル: ルールに含めるプリンシパル。
- 除外されたプリンシパル: ルールから除外するプリンシパル。含まれるプリンシパルのリストのグループに属している場合でも除外されます。
この 2 つのリストを使用すると、ルールに含めるプリンシパルを簡潔に指定できます。たとえば、example.com のユーザーにアクセス権を付与する許可ルールを作成するとします。ユーザー reduced-access@example.com を除くグループ all@example.com のすべてのユーザーにアクセス権を付与する場合は、含まれるプリンシパルのリストに all@example.com を追加し、除外されるプリンシパルのリストに reduced-access@example.com を追加します。
統合アクセス ポリシー ルールのロールと権限
ルールに含める権限の正確なリストを作成するには、次を定義します。
- 含まれる権限: ルールに含める権限。
- 除外される権限: 含まれる権限のリストのロールまたは権限グループに含まれている場合でも、ルールに含めない権限。
含まれる権限または除外される権限のリストに権限を追加するには、次のいずれかを参照します。
権限: 完全修飾ドメイン名(FQDN)形式の個々の権限名。例:
cloudresourcemanager.googleapis.com/projects.getロール(許可ルールのみ): 事前定義ロール名(
roles/logging.logsViewerなど)。ルールにロール名を含めると、そのロールのすべての権限がルールに含まれます。ロールに含まれるすべての権限を確認するには、ロールと権限のリファレンスをご覧ください。UAP JSON では、これらの名前の前に常に
role:が付きます(例:role:roles/logging.logsViewer)。ロールは許可ルールでのみ許可されます。カスタムロールは、どのルールでもサポートされていません。
権限グループ:
aiplatform.googleapis.com/*.*などの権限のセット。権限グループは、指定されたパターンに一致する権限のセットです。参照できる権限グループと、それらのグループに含まれる権限には、いくつかの制限があります。詳細については、このページの権限グループをご覧ください。
権限グループ
権限グループは、指定されたパターンに一致する権限のセットです。権限グループを使用すると、関連する一連の権限を付与または拒否できます。たとえば、1 つのサービスに対するすべての権限を拒否したり、特定の動詞で終わるすべての権限を付与したりできます。
権限グループは、許可ルールと拒否ルールで動作が異なります。以降のセクションでは、各ルールタイプで権限グループを使用する方法について説明します。
許可ルールの権限グループ
許可ルールで権限グループを識別するには、権限名の 1 つ以上のセクションをワイルドカード文字(*)に置き換えます。各グループに含まれる権限は、ワイルドカードの位置によって異なります。
SERVICE_FQDN/RESOURCE.*: 指定されたリソースに対するすべての権限が含まれます。SERVICE_FQDN/*.*: 指定されたサービスのすべての権限が含まれます。SERVICE_FQDN/*.VERB: 指定された動詞で終わるサービスのすべての権限が含まれます。*/*.VERB: 指定された動詞で終わるすべての権限が含まれます。*: すべての権限が含まれます。この値は、除外された権限ではなく、含まれる権限を一覧表示する場合にのみ使用できます。
権限グループには、カスタムロールでサポートされている権限のみが含まれます。指定された形式に一致していても、他の権限は含まれません。
カスタムロールでサポートされている権限については、カスタムロールでの権限のサポートレベルをご覧ください。
このページに記載されている権限は、UAP の権限と同じ形式を使用していません。
- カスタムロールでは、権限名に
v1形式(SERVICE_ID.RESOURCE.VERB)を使用します。 - UAP では、権限名に完全修飾ドメイン名形式(
SERVICE_FQDN/RESOURCE.VERB)を使用します。
ただし、SERVICE_ID と SERVICE_FQDN の値は通常、類似しています。ほとんどの場合、SERVICE_FQDN の値は v1 API の SERVICE_ID の値の後に .googleapis.com を付けたものです。たとえば、ロールを削除する権限は、次の方法で記述できます。
v1形式:iam.roles.delete- 完全修飾ドメイン名の形式:
iam.googleapis.com/roles.delete
この類似性を利用して、許可ルールの権限グループを確認するときに、2 つの形式間で変換できます。
このルールにはいくつかの例外があります。これらの例外を確認するには、拒否ポリシーでサポートされている権限のリストを確認し、フィルタ フィールドで IAM v1 API を検索します。
拒否ルールの権限グループ
拒否ルールは、特定の権限グループのみをサポートしています。サポートされている権限グループは、拒否ポリシーでサポートされている権限に記載されています。サポートされている権限グループの ID では、権限名の 1 つ以上のセクションをワイルドカード文字(*)に置き換えます。各グループに含まれる権限は、ワイルドカードの位置によって異なります。
SERVICE_FQDN/RESOURCE.*: 指定されたリソースに対するすべての権限を拒否します。SERVICE_FQDN/*.*: 指定されたサービスのすべての権限を拒否します。SERVICE_FQDN/*.VERB: 指定された動詞で終わるサービスのすべての権限を拒否します。
権限グループには、指定されたパターンに一致する現在と将来のすべての権限が含まれます。たとえば、権限グループ example.googleapis.com/exampleResource.* を使用して、ユーザーに対して exampleResource リソースタイプのすべての権限を拒否するとします。example.googleapis.com が exampleResource リソースタイプの新しい権限(example.googleapis.com/exampleResource.newPermission など)を追加すると、そのユーザーに対して新しい権限が自動的に拒否されます。
ワイルドカードは、サポートされている権限グループでのみ使用できます。拒否ルールの他の権限名でワイルドカードを使用することはできません。
統合アクセス ポリシーを作成する
UAP は、プロジェクト、フォルダ、組織で作成できます。UAP を作成するリソースが UAP の親になります。ただし、UAP を適用するまで、UAP は有効になりません。
UAP の親は UAP の名前に表示されます。ポリシー名の形式は RESOURCE_TYPE/RESOURCE_ID/locations/global/accessPolicies/POLICY_ID です。プレースホルダは次のものを表します。
RESOURCE_TYPE: UAP が作成されたリソースのタイプ。この値は、projects、folders、organizationsのいずれかです。RESOURCE_ID: UAP が作成されたリソースの ID。POLICY_ID: UAP の英数字 ID。
たとえば、プロジェクト example-project に UAP example-policy を作成した場合、その UAP の親リソースは example-project で、UAP の名前は projects/example-project/locations/global/accessPolicies/example-policy です。
統合アクセス ポリシーを作成する場所
UAP の親は、UAP を適用できるリソースに影響しません。ただし、UAP の表示と編集の権限を持つユーザーには影響します。適切なユーザーが適切な UAP を表示および編集する権限を持つように、UAP のスコープを最もよく反映する親リソースを選択することをおすすめします。
たとえば、組織に UAP を適用する場合は、組織に UAP を作成することをおすすめします。
リソースにポリシーを適用する
UAP を適用するには、バインディングを作成します。各バインディングでは、UAP と、UAP をバインドするリソースを指定します。バインディングを作成すると、UAP のルールは、そのリソースとそのリソースの子孫に対して有効になります。
たとえば、UAP compute-access-management があるとします。この UAP は、グループ compute-users@example.com に Compute 編集者のロール(roles/compute.editor)を付与し、compute-users@example.com を除くすべてのユーザーに compute.googleapis.com/instances.* 権限を拒否します。
バインディングがない場合、この UAP は機能しません。
この UAP を組織 example.com のすべてのリソースに適用するため、compute-access-management UAP を example.com に接続するバインディングを作成します。バインディングを作成すると、UAP には次の効果があります。
compute-users@example.comのメンバーは、Compute 編集者のロールの権限を使用して、example.comのリソースにアクセスできます。compute-users@example.comのメンバーではないすべてのユーザーは、インスタンス関連の権限を使用してexample.comのリソースにアクセスできなくなります。
サポートされているリソース
次の表に、UAP をバインドできるリソースを示します。各行の内容は次のとおりです。
- リソースのタイプ
- そのリソースの ID の形式
- そのタイプのリソースのバインディングを親とする Resource Manager リソース(プロジェクト、フォルダ、組織)
| リソース | リソース ID | バインディングの親リソース |
|---|---|---|
| Resource Manager プロジェクト | //cloudresourcemanager.googleapis.com/projects/PROJECT_ID |
バインディング内のプロジェクト |
| Resource Manager フォルダ | //cloudresourcemanager.googleapis.com/folders/FOLDER_ID |
バインディング内のフォルダ |
| Resource Manager 組織 | //cloudresourcemanager.googleapis.com/organizations/ORG_ID |
バインディング内の組織 |
| Agent Registry AI アプリケーション | //agentregistry.googleapis.com/projects/PROJECT_ID/locations/LOCATION/aiApplications/APPLICATION_ID |
アプリケーションの親プロジェクト |
| Network Services API Agent Gateway | //networkservices.googleapis.com/projects/PROJECT_ID/locations/LOCATION/agentGateways/GATEWAY_ID |
ゲートウェイの親プロジェクト |
バインディングの作成を無効にする
組織でバインディングの作成を無効にする場合は、組織で iam.managed.disableAccessPolicyBinding 組織のポリシー制約を適用します。この制約により、組織内のプリンシパルが UAP のバインディングを作成できなくなります。
この制約を有効または無効にする方法については、組織のポリシーでマネージド制約を使用するをご覧ください。
ポリシーの継承
UAP をプロジェクト、フォルダ、組織にバインドすると、その UAP はリソース階層を介して継承されます。
リソース階層は、最上位の組織(ルート)、グループ化用のフォルダ(省略可)、プロジェクトで構成されます。プロジェクトには、Compute Engine 仮想マシンや Cloud Storage バケットなどのサービス固有のリソースが含まれます。
この階層では、プロジェクト、フォルダ、組織は親リソースです。つまり、他のリソースを含むリソースです。
- プロジェクトには、サービス固有のリソースが含まれます。
- フォルダには、他のフォルダ、プロジェクト、プロジェクトのリソースが含まれます。
- 組織には、フォルダ、プロジェクト、プロジェクトのリソースが含まれます。
親リソースに含まれるリソースは、そのリソースの子孫です。
UAP を親リソースにバインドすると、その UAP は親リソースとそのリソースのすべての子孫に適用されます。つまり、UAP はリソースの子孫に継承されます。
ポリシーの継承により、1 つのバインディングで大量のリソースにポリシーを適用できます。たとえば、taylor@example.com に Compute Engine 管理者ロール(roles/compute.admin)を付与する UAP を作成するとします。この UAP は、noam@example.com に compute.googleapis.com/instances.delete 権限を拒否します。
この UAP を組織 example.com のすべてのリソースに適用します。これを行うには、この UAP を組織リソースにバインドします。UAP を組織にバインドすると、UAP はその組織内のすべてのリソースに継承されます。
UAP を組織にバインドすると、次のような影響があります。
taylor@example.comは、Compute Engine 管理者ロールの権限を使用して、example.com内の任意のリソースにアクセスできます。noam@example.comは、下位リソースの UAP でアクセス権が付与されていても、example.comのリソースに対してcompute.googleapis.com/instances.delete権限を使用できません。
UAP を適用するリソースを減らす場合は、UAP をリソース階層の下位レベル(プロジェクトやサポートされているサービス固有のリソースなど)にバインドします。
組織間のバインディング
UAP の組織間のバインディングは作成できません。組織間のバインディングは、ある組織の UAP を別の組織のリソースにバインドするバインディングです。
IAM は、既存の組織間のバインディングを定期的に削除します。組織間のバインディングは、ある組織から別の組織にプロジェクトを移動するときに発生する可能性があります。次の状況について考えてみましょう。
- 組織
example.comにプロジェクトexample-projectがあります。 - プロジェクト
example-projectに UAP を作成し、example-projectにバインドします。 example-projectをexample.comからcymbalgroup.comに移動します。
この状況でプロジェクトを移動すると、組織間のバインディングが作成されます。これは、example.com の UAP が cymbalgroup.com のリソースにバインドされているためです。バインディングを手動で削除しない場合、最終的に IAM によって自動的に削除されます。このバインディングを削除すると、cymbalgroup.com 管理者は組織内のリソースにバインドされているすべての UAP にアクセスできるようになります。
削除された統合アクセス ポリシーのバインディング
通常、UAP を削除する前に、UAP のバインディングを削除する必要があります。既存のバインディングがある UAP を削除しようとすると、エラーが発生します。
ただし、既存のバインディングを削除せずに UAP を削除する場合は、UAP を強制的に削除できます。
UAP を強制的に削除すると、バインドされているすべてのリソースから UAP が削除されます。UAP を参照するバインディングは最終的に削除されます。ただし、それらのバインディングは、削除されるまで、1 つのリソースを参照できるバインディング数の上限に引き続きカウントされます。
統合アクセス ポリシーの条件
IAM Conditions を使用すると、 Google Cloud リソースに条件付きの属性ベースのアクセス制御を定義して適用できます。UAP では、個々のルールに条件を追加して、そのルールが適用されるタイミングを制御できます。UAP バインディングに条件を追加することはできません。
条件は、タイトル、説明、ブール式で構成されます。リクエストに対して式が true と評価された場合、そのリクエストにルールが適用されます。false と評価された場合、ルールはリクエストに適用されません。
サービスによって、条件式の記述に使用できる属性と関数が異なります。ルールに条件を追加する場合は、常に、使用する属性と関数のサービス名を条件の前に付けます。1 つのルールに複数の条件を追加できますが、1 つの条件で異なるサービスの属性を混在させることはできません。
たとえば、IAM が提供する属性を使用する条件を追加する場合は、条件の前に iam.googleapis.com を付けます。
"conditions": {
"iam.googleapis.com": {
"title": "CONDITION_TITLE",
"description": "CONDITION_DESCRIPTION",
"expression": "CONDITION_EXPRESSION"
}
}
条件付きの UAP ルールを作成する方法については、UAP を作成して適用するをご覧ください。
条件属性に適用される権限
サービス固有の属性の一部は、特定の権限を含むリクエストにのみ適用されます。たとえば、eventarc.googleapis.com 属性 message.id は、eventarc.googleapis.com/messageBuses.publish 権限を必要とするリクエストにのみ適用されます。
これらの属性は、該当する権限を含むルールでのみ使用できます。該当する権限なしでルールで属性を使用しようとすると、UAP の作成は失敗します。
サポートされている条件の属性
UAP ルールでは、次の属性がサポートされています。
| サービス | 属性 | 該当する権限 | 詳細 |
|---|---|---|---|
iam.googleapis.com(プレビュー) |
リソースタグ | すべて | リソースタグ属性 |
eventarc.googleapis.com(プレビュー) |
メッセージ | eventarc.googleapis.com/messageBuses.publish |
Eventarc メッセージ属性 |
iap.googleapis.com(GA) |
宛先 | iap.googleapis.com/resources.egressViaIAP |
Identity-Aware Proxy の宛先属性 |
次のステップ
- UAP を作成して適用する方法を学習する。
- 既存の UAP を表示する方法を確認する。