統合アクセス ポリシー(UAP)を使用すると、プリンシパルにGoogle Cloud リソースへのアクセス権を付与したり、アクセスを拒否したりできます。このドキュメントでは、UAP を作成して適用する方法について説明します。
始める前に
認証を設定する。
このページのサンプルをどのように使うかに応じて、タブを選択してください。
コンソール
Google Cloud コンソールを使用して Google Cloud サービスと API にアクセスする場合、認証を設定する必要はありません。
gcloud
Google Cloud コンソールで Cloud Shell をアクティブにします。
Google Cloud コンソールの下部で Cloud Shell セッションが開始し、コマンドライン プロンプトが表示されます。Cloud Shell はシェル環境です。Google Cloud CLI がすでにインストールされており、現在のプロジェクトの値もすでに設定されています。セッションが初期化されるまで数秒かかることがあります。
REST
このページの REST API サンプルをローカル開発環境で使用するには、gcloud CLI に指定した認証情報を使用します。
Google Cloud CLI をインストールします。
外部 ID プロバイダ(IdP)を使用している場合は、まず連携 ID を使用して gcloud CLI にログインする必要があります。
詳細については、 Google Cloud 認証ドキュメントの REST を使用して認証するをご覧ください。
省略可: UAP の概要を確認します。
統合アクセス ポリシーの作成に必要なロール
UAP の作成に必要な権限を取得するには、ポリシーを作成するプロジェクト、フォルダ、または組織に対するアクセス ポリシー管理者(roles/iam.accessPolicyAdmin)IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織に対するアクセス権の管理をご覧ください。
この事前定義ロールには、UAP の作成に必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。
必要な権限
UAP を作成するには、次の権限が必要です。
-
iam.accesspolicies.create -
Google Cloud コンソールで UAP を作成します。
iam.accesspolicies.list
カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。
統合アクセス ポリシーの適用に必要なロール
UAP をリソースにバインドするために必要な権限を取得するには、次の IAM ロールを付与するよう管理者に依頼してください。
- UAP を所有するリソースに対するアクセス ポリシー管理者(
roles/iam.accessPolicyAdmin)。このロールには、バインディングの作成に必要なiam.accesspolicies.bind権限が含まれています。 SERVICE.RESOURCE.createPolicyBinding権限を含むロール。ここで、RESOURCEはポリシーをバインドするリソースタイプ、SERVICEはリソースを所有するサービスです。必要な権限を含むロールを見つけるには、ロールと権限のリファレンスで権限を検索し、権限名をクリックして、その権限を含むロールを確認します。
このロールは、リソースまたはその祖先のいずれかに必要です。
ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。
統合アクセス ポリシーの作成
UAP は、 Google Cloud コンソール、gcloud CLI、IAM REST API を使用して作成できます。
コンソール
-
Google Cloud コンソールで、[統合アクセス ポリシー] ページに移動します。
[統合アクセス ポリシー] に移動 - UAP を作成するプロジェクト、フォルダ、または組織を選択します。UAP を作成する場所については、UAP を作成する場所をご覧ください。
- [ ポリシーを作成] をクリックします。
-
[ポリシー名] フィールドに、UAP の名前を入力します(例:
Example policy)。名前は 63 文字以下にしてください。 - 省略可: [ポリシー ID] フィールドで、UAP の ID をカスタマイズします。
-
ポリシーにルールを追加します。ルールごとに次の操作を行います。
- 省略可: [説明] フィールドに、ルールの説明を入力します。
- [プリンシパル] フィールドに、ルールに含めるプリンシパルを入力します。
- 省略可: [除外されたプリンシパル] フィールドに、ルールに含めないプリンシパルを入力します。これらのプリンシパルは、[プリンシパル] フィールドのグループに含まれている場合でも、含まれません。
-
ルールに適用する効果を選択します。
- 指定したプリンシパルに指定した権限を付与するには、[許可] 効果を選択します。
- 指定したプリンシパルが指定した権限を使用できないようにするには、[拒否] 効果を選択します。
-
ルールに含める権限を選択します。
- 許可効果を持つルールの場合、ルールに含めるロールと権限、またはルールから除外するロールと権限を指定できます。含めることができるロールと権限の詳細については、UAP ルールのロールと権限をご覧ください。
- 拒否効果を持つルールの場合、ルールに含める権限またはルールから除外する権限を指定します。含めることができる権限の詳細については、UAP ルールのロールと権限をご覧ください。
-
省略可: ルールを適用する条件を追加します。サポートされている条件属性の詳細については、UAP の条件をご覧ください。
- ルールの編集が完了したら、[完了] をクリックします。
- 別のルールを追加するには、[ルールを追加] をクリックして、ルールの詳細を追加します。
- ルールの追加が完了したら、[ポリシーを作成] をクリックします。
gcloud
gcloud iam access-policies create コマンドは、UAP を作成します。
後述のコマンドデータを使用する前に、次のように置き換えます。
-
UAP_ID: UAP の一意の ID(例:example-policy)。 -
UAP_PARENT_RESOURCE_TYPE: UAP を作成する Resource Manager リソースのタイプ(プロジェクト、フォルダ、組織)。値project、folder、またはorganizationを使用します。 -
UAP_PARENT_RESOURCE_ID: UAP を作成するプロジェクト、フォルダ、または組織の ID。プロジェクト ID は英数字からなる文字列です(例:my-project)。フォルダ ID と組織 ID は数値です(例:123456789012)。 DISPLAY_NAME: 省略可。人が読める形式の UAP の説明(例:Example policy)。表示名は 63 文字以内にしてください。-
FILE_PATH: UAP ルールの詳細を含む JSON ファイルのパス。各ルールの形式は次のとおりです。{ "description": "DESCRIPTION", "effect": "EFFECT", "principals": [ INCLUDED_PRINCIPALS ], "excludedPrincipals": [ EXCLUDED_PRINCIPALS ], "operation": { "permissions": [ INCLUDED_PERMISSIONS ], "excludedPermissions": [ EXCLUDED_PERMISSIONS ] }, CONDITIONS }
次の値を置き換えます。
-
DESCRIPTION: 人が読める形式のルールの説明。 -
EFFECT: ルールがアクセスにどのように影響するか。サポートされている値はALLOWとDENYです。-
ALLOW: 指定されたプリンシパルに指定された権限を付与します。 -
DENY: 指定されたプリンシパルが指定された権限を使用できないようにします。
-
-
次の値を置き換えて、ルールに含まれるプリンシパルを指定します。
-
INCLUDED_PRINCIPALS: ルールに含めるプリンシパル。 -
EXCLUDED_PRINCIPALS: 省略可。含まれるプリンシパルのリストに含まれている場合でも、ルールから除外するプリンシパル。たとえば、含まれるプリンシパルのリストに Google グループを追加し、そのグループに属する特定のユーザーを除外できます。
サポートされているプリンシパル ID の一覧については、UAP のプリンシパル タイプをご覧ください。
-
-
次の値を置き換えて、ルールに含める権限を指定します。
-
INCLUDED_PERMISSIONS: ルールに含める権限。 -
EXCLUDED_PERMISSIONS: 省略可。ルールから除外する権限。含まれる権限のリストに含まれている場合でも除外されます。たとえば、含まれる権限のリストにロールを追加してから、そのロールの特定の権限を除外できます。
これらの権限リストを作成する際には、権限名、ロール名、権限グループを参照できます。詳細については、UAP ルールのロールと権限をご覧ください。
-
-
CONDITIONS: 省略可。ルールが適用される条件。形式は次のようにします。"conditions": { "SERVICE": { "title": "CONDITION_TITLE", "description": "CONDITION_DESCRIPTION", "expression": "CONDITION_EXPRESSION" } }
次の値を置き換えます。
-
SERVICE: 条件式で使用される属性を提供するサービス。 -
CONDITION_TITLE: 省略可。条件の目的の概要。 -
CONDITION_DESCRIPTION: 省略可。条件の詳しい説明。 -
CONDITION_EXPRESSION: アクセス試行の属性(アクセス試行でリソースに適用されたタグなど)を参照するブール式。式がtrueと評価された場合、アクセス試行にルールが適用されます。falseと評価された場合、ルールはアクセス試行に適用されません。
サポート属性とそのサービスの一覧については、サポートされている条件属性をご覧ください。
-
-
次のコマンドを実行します。
Linux、macOS、Cloud Shell
gcloud iam access-policies create UAP_ID \ --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID \ --location=global --display-name=DISPLAY_NAME \ --details-rules=FILE_PATH
Windows(PowerShell)
gcloud iam access-policies create UAP_ID ` --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID ` --location=global --display-name=DISPLAY_NAME ` --details-rules=FILE_PATH
Windows(cmd.exe)
gcloud iam access-policies create UAP_ID ^ --UAP_PARENT_RESOURCE_TYPE=UAP_PARENT_RESOURCE_ID ^ --location=global --display-name=DISPLAY_NAME ^ --details-rules=FILE_PATH
レスポンスには、リクエストを表す長時間実行オペレーションが含まれます。長時間実行オペレーションのステータスを取得する方法については、このページの長時間実行オペレーションのステータスを確認するをご覧ください。
Create request issued for: [example-policy] Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715373988044-6181fa136df85-3b06a30a-4816d25b] to complete...done. Created accessPolicy [example-policy].
REST
accessPolicies.create メソッドは UAP を作成します。
リクエストのデータを使用する前に、次のように置き換えます。
-
UAP_PARENT_RESOURCE_TYPE: UAP を作成する Resource Manager リソースのタイプ(プロジェクト、フォルダ、組織)。値projects、folders、またはorganizationsを使用します。 -
UAP_PARENT_RESOURCE_ID: UAP を作成するプロジェクト、フォルダ、または組織の ID。プロジェクト ID は英数字からなる文字列です(例:my-project)。フォルダ ID と組織 ID は数値です(例:123456789012)。 -
UAP_ID: UAP の一意の ID(例:example-policy)。 DISPLAY_NAME: 省略可。人が読める形式の UAP の説明(例:Example policy)。表示名は 63 文字以内にしてください。-
UAP_RULES: UAP ルールのリスト。許可または拒否するアクセス権と、アクセス権を許可または拒否するプリンシパルを定義します。UAP には最大 100 個のルールを設定できます。各ルールの形式は次のとおりです。{ "description": "DESCRIPTION", "effect": "EFFECT", "principals": [ INCLUDED_PRINCIPALS ], "excludedPrincipals": [ EXCLUDED_PRINCIPALS ], "operation": { "permissions": [ INCLUDED_PERMISSIONS ], "excludedPermissions": [ EXCLUDED_PERMISSIONS ] }, CONDITIONS }
次の値を置き換えます。
-
DESCRIPTION: 人が読める形式のルールの説明。 -
EFFECT: ルールがアクセスにどのように影響するか。サポートされている値はALLOWとDENYです。-
ALLOW: 指定されたプリンシパルに指定された権限を付与します。 -
DENY: 指定されたプリンシパルが指定された権限を使用できないようにします。
-
-
次の値を置き換えて、ルールに含まれるプリンシパルを指定します。
-
INCLUDED_PRINCIPALS: ルールに含めるプリンシパル。 -
EXCLUDED_PRINCIPALS: 省略可。含まれるプリンシパルのリストに含まれている場合でも、ルールから除外するプリンシパル。たとえば、含まれるプリンシパルのリストに Google グループを追加し、そのグループに属する特定のユーザーを除外できます。
サポートされているプリンシパル ID の一覧については、UAP のプリンシパル タイプをご覧ください。
-
-
次の値を置き換えて、ルールに含める権限を指定します。
-
INCLUDED_PERMISSIONS: ルールに含める権限。 -
EXCLUDED_PERMISSIONS: 省略可。ルールから除外する権限。含まれる権限のリストに含まれている場合でも除外されます。たとえば、含まれる権限のリストにロールを追加してから、そのロールの特定の権限を除外できます。
これらの権限リストを作成する際には、権限名、ロール名、権限グループを参照できます。詳細については、UAP ルールのロールと権限をご覧ください。
-
-
CONDITIONS: 省略可。ルールが適用される条件。形式は次のようにします。"conditions": { "SERVICE": { "title": "CONDITION_TITLE", "description": "CONDITION_DESCRIPTION", "expression": "CONDITION_EXPRESSION" } }
次の値を置き換えます。
-
SERVICE: 条件式で使用される属性を提供するサービス。 -
CONDITION_TITLE: 省略可。条件の目的の概要。 -
CONDITION_DESCRIPTION: 省略可。条件の詳しい説明。 -
CONDITION_EXPRESSION: アクセス試行の属性(アクセス試行でリソースに適用されたタグなど)を参照するブール式。式がtrueと評価された場合、アクセス試行にルールが適用されます。falseと評価された場合、ルールはアクセス試行に適用されません。
サポート属性とそのサービスの一覧については、サポートされている条件属性をご覧ください。
-
-
HTTP メソッドと URL:
POST https://iam.googleapis.com/v3/UAP_PARENT_RESOURCE_TYPE/UAP_PARENT_RESOURCE_ID/locations/global/accessPolicies?accessPolicyId=UAP_ID
リクエストの本文(JSON):
{
"displayName": "DISPLAY_NAME",
"details": {
"rules": [
UAP_RULES
]
}
}
リクエストを送信するには、次のいずれかのオプションを展開します。
レスポンスには、リクエストを表す長時間実行オペレーションが含まれます。長時間実行オペレーションのステータスを取得する方法については、このページの長時間実行オペレーションのステータスを確認するをご覧ください。
{
"name": "organizations/123456789012/locations/global/operations/operation-1715373120647-6181f6d8371d2-83309b71-2b8a7532",
"metadata": {
"@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
"createTime": "2026-05-10T20:32:00.898809495Z",
"target": "organizations/123456789012/locations/global/accessPolicies/example-policy",
"verb": "create",
"requestedCancellation": false,
"apiVersion": "v3"
},
"done": false
}
リソースに統合アクセス ポリシーを適用する
リソースに UAP を適用するには、バインディングを作成します。ポリシーのバインディングを作成すると、そのポリシーのルールは、指定されたリソースとそのリソースの子孫に対して有効になります。
バインディングを作成する前に、iam.managed.disableAccessPolicyBinding 組織のポリシー制約が無効になっていることを確認します。この制約を有効または無効にする方法については、組織のポリシーでマネージド制約を使用するをご覧ください。
UAP をプロジェクト、フォルダ、組織に適用するには、 Google Cloud コンソール、gcloud CLI、または IAM REST API を使用します。他のリソースに UAP を適用するには、gcloud CLI または IAM REST API を使用する必要があります。
コンソール
-
Google Cloud コンソールで、[統合アクセス ポリシー] ページに移動します。
[統合アクセス ポリシー] に移動 - 適用する UAP を所有するプロジェクト、フォルダ、または組織を選択します。
- 適用する UAP の ID をクリックします。
- [バインディング] タブを選択し、[ バインディングを追加] をクリックします。
-
[バインディングを追加] ペインで、バインディングの詳細を編集します。
- [バインディングの場所] メニューで、UAP を適用するリソースを選択します。
-
省略可: [バインディングの表示名] フィールドに、バインディングの対人可読の説明を入力します(例:
Example binding)。表示名は 63 文字以内にしてください。 -
[バインディング ID] フィールドに、バインディングの一意の名前(
example-bindingなど)を入力します。
- [バインディングを追加] をクリックします。
gcloud
gcloud iam policy-bindings create コマンドは、バインディングを作成します。
後述のコマンドデータを使用する前に、次のように置き換えます。
-
BINDING_ID: バインディングの一意の名前(例:example-binding)。 -
BINDING_PARENT_RESOURCE_TYPE: バインディングが子である Resource Manager リソースのタイプ(プロジェクト、フォルダ、組織)。値project、folder、またはorganizationを使用します。バインディングの親リソースは、バインディングのターゲット リソースによって異なります。詳細については、サポート対象のリソースをご覧ください。
-
BINDING_PARENT_RESOURCE_ID: ポリシー バインディングが子であるプロジェクト、フォルダ、または組織の ID。プロジェクト ID は英数字からなる文字列です(例:my-project)。フォルダ ID と組織 ID は数値です(例:123456789012)。 -
POLICY_PARENT_RESOURCE: UAP が作成されたリソース(RESOURCE_TYPE/RESOURCE_ID形式)。例:organizations/0123456789012。UAP は、プロジェクト、フォルダ、または組織に作成できます。フォルダ ID と組織 ID は数値にする必要があります。プロジェクト ID に使用可能な形式は数値または英数字です。 -
UAP_ID: リソースにバインドする UAP の ID(例:example-uap)。バインディングの作成後にこの値を変更することはできません。 -
TARGET_RESOURCE: UAP をバインドするリソース。有効なリソースの一覧については、サポートされているリソースをご覧ください。バインディングの作成後にこの値を変更することはできません。 DISPLAY_NAME: 省略可。人が読める形式のバインディングの説明(例:Example binding)。表示名は 63 文字以内にしてください。
次のコマンドを実行します。
Linux、macOS、Cloud Shell
gcloud iam policy-bindings create BINDING_ID \ --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID --location=global \ --policy="POLICY_PARENT_RESOURCE/locations/global/accessPolicies/UAP_ID" \ --target-resource=TARGET_RESOURCE \ --display-name=DISPLAY_NAME
Windows(PowerShell)
gcloud iam policy-bindings create BINDING_ID ` --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID --location=global ` --policy="POLICY_PARENT_RESOURCE/locations/global/accessPolicies/UAP_ID" ` --target-resource=TARGET_RESOURCE ` --display-name=DISPLAY_NAME
Windows(cmd.exe)
gcloud iam policy-bindings create BINDING_ID ^ --BINDING_PARENT_RESOURCE_TYPE=BINDING_PARENT_RESOURCE_ID --location=global ^ --policy="POLICY_PARENT_RESOURCE/locations/global/accessPolicies/UAP_ID" ^ --target-resource=TARGET_RESOURCE ^ --display-name=DISPLAY_NAME
レスポンスには、リクエストを表す長時間実行オペレーションが含まれます。長時間実行オペレーションのステータスを取得する方法については、このページの長時間実行オペレーションのステータスを確認するをご覧ください。
Create request issued for: [example-binding] Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374545618-6181fc272c6f9-55ff07f4-97d0ac76] to complete...done. Created policyBinding [example-binding].
REST
policyBindings.create メソッドはバインディングを作成します。
リクエストのデータを使用する前に、次のように置き換えます。
-
BINDING_PARENT_RESOURCE_TYPE: バインディングが子である Resource Manager リソースのタイプ(プロジェクト、フォルダ、組織)。値projects、folders、またはorganizationsを使用します。バインディングの親リソースは、バインディングのターゲット リソースによって異なります。詳細については、サポート対象のリソースをご覧ください。
-
BINDING_PARENT_RESOURCE_ID: ポリシー バインディングが子であるプロジェクト、フォルダ、または組織の ID。プロジェクト ID は英数字からなる文字列です(例:my-project)。フォルダ ID と組織 ID は数値です(例:123456789012)。 -
BINDING_ID: バインディングの一意の名前(例:example-binding)。 DISPLAY_NAME: 省略可。人が読める形式のバインディングの説明(例:Example binding)。表示名は 63 文字以内にしてください。-
TARGET_RESOURCE: UAP をバインドするリソース。有効なリソースの一覧については、サポートされているリソースをご覧ください。バインディングの作成後にこの値を変更することはできません。 -
POLICY_PARENT_RESOURCE: UAP が作成されたリソース(RESOURCE_TYPE/RESOURCE_ID形式)。例:organizations/0123456789012。UAP は、プロジェクト、フォルダ、または組織に作成できます。フォルダ ID と組織 ID は数値にする必要があります。プロジェクト ID に使用可能な形式は数値または英数字です。 -
UAP_ID: リソースにバインドする UAP の ID(例:example-uap)。バインディングの作成後にこの値を変更することはできません。
HTTP メソッドと URL:
POST https://iam.googleapis.com/v3/BINDING_PARENT_RESOURCE_TYPE/BINDING_PARENT_RESOURCE_ID/locations/global/policyBindings?policyBindingId=BINDING_ID
リクエストの本文(JSON):
{
"displayName": "DISPLAY_NAME",
"target": {
"resource": "TARGET_RESOURCE"
},
"policyKind": "ACCESS",
"policy": "POLICY_PARENT_RESOURCE/locations/global/accessPolicies/UAP_ID"
}
リクエストを送信するには、次のいずれかのオプションを展開します。
レスポンスには、リクエストを表す長時間実行オペレーションが含まれます。長時間実行オペレーションのステータスを取得する方法については、このページの長時間実行オペレーションのステータスを確認するをご覧ください。
{
"name": "organizations/123456789012/locations/global/operations/operation-1715373120647-6181f6d8371d2-83309b71-2b8a7532",
"metadata": {
"@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
"createTime": "2026-05-10T20:32:00.898809495Z",
"target": "organizations/123456789012/locations/global/policyBindings/example-binding",
"verb": "create",
"requestedCancellation": false,
"apiVersion": "v3"
},
"done": false
}
長時間実行オペレーションのステータスを確認する
REST API またはクライアント ライブラリを使用する場合、ポリシーまたはバインディングを変更するメソッドで長時間実行オペレーション(LRO)が返されます。長時間実行オペレーションは、リクエストのステータスを追跡し、ポリシーまたはバインディングの変更が完了したかどうかを示します。
REST
operations.get メソッドは、長時間実行オペレーションのステータスを返します。
リクエストのデータを使用する前に、次のように置き換えます。
-
OPERATION_NAME: オペレーションの完全な名前。この名前は、元のリクエストに対するレスポンスで受け取ります。オペレーション名の形式は次のとおりです。
RESOURCE_TYPE/RESOURCE_ID/locations/global/operations/OPERATION_ID
HTTP メソッドと URL:
GET https://iam.googleapis.com/v3/OPERATION_NAME
リクエストを送信するには、次のいずれかのオプションを展開します。
次のような JSON レスポンスが返されます。
{
"name": "organizations/314340013352/locations/global/operations/operation-1732752311821-627edd607a3df-9a62cdea-2a7d9f07",
"metadata": {
"@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
"createTime": "2024-11-28T00:05:12.006289686Z",
"endTime": "2024-11-28T00:05:12.192141801Z",
"target": "organizations/314340013352/locations/global/POLICY_TYPE/POLICY_ID",
"verb": "create",
"requestedCancellation": false,
"apiVersion": "v3"
},
"done": true,
"response": {
POLICY
}
}
オペレーションの done フィールドが存在しない場合は、オペレーションを繰り返し取得して、ステータスのモニタリングを続行します。各リクエストの間には、切り捨て型指数バックオフを使用して遅延時間を設けてください。done フィールドが true に設定されている場合、オペレーションは完了しており、オペレーションの取得を停止できます。