拒绝允许用户授予访问权限的权限,有助于防止未经授权的提权,并加强安全控制。本文档介绍了如何识别这些权限,并创建拒绝政策,以阻止大多数用户使用这些权限,同时允许受信任的主账号例外。
准备工作
启用 IAM API(如果尚未启用)。
启用 API 所需的角色
如需启用 API,您需要拥有
serviceusage.services.enable权限。如果您创建了项目,则可能已经通过 Owner 角色 (roles/owner) 拥有此权限。否则,您可以通过 Service Usage Admin 角色 (roles/serviceusage.serviceUsageAdmin) 获得此权限。了解如何授予角色。设置身份验证。
选择标签页以了解您打算如何使用本页面上的示例:
控制台
当您使用 Google Cloud 控制台访问 Google Cloud 服务和 API 时,无需设置身份验证。
gcloud
在 Google Cloud 控制台中,激活 Cloud Shell。
Cloud Shell 会话随即会在 Google Cloud 控制台的底部启动,并显示命令行提示符。Cloud Shell 是一个已安装 Google Cloud CLI 且已为当前项目设置值的 Shell 环境。该会话可能需要几秒钟时间来完成初始化。
REST
如需在本地开发环境中使用本页面上的 REST API 示例,请使用您提供给 gcloud CLI 的凭证。
安装 Google Cloud CLI。
如果您使用的是外部身份提供方 (IdP),则必须先使用联合身份登录 gcloud CLI。
如需了解详情,请参阅 Google Cloud 身份验证文档中的使用 REST 时进行身份验证。
可选:阅读拒绝政策概览。
所需的角色
如需获得创建拒绝政策所需的权限,请让您的管理员为您授予组织的 Deny Admin (roles/iam.denyAdmin) IAM 角色。如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限。
此预定义角色包含创建拒绝政策所需的 iam.denypolicies.create 权限。
确定允许用户授予访问权限的权限
在创建拒绝政策以阻止用户授予访问权限之前,请确定要拒绝的权限。
以下权限可让用户授予访问权限:
以
setIamPolicy结尾的权限。这些权限中权限范围最广的是 Resource Manager 资源的权限,因为这些资源的允许政策会被所有后代资源继承。这些权限如下:cloudresourcemanager.googleapis.com/projects.setIamPolicycloudresourcemanager.googleapis.com/folders.setIamPolicycloudresourcemanager.googleapis.com/organizations.setIamPolicy
其他资源也具有
setIamPolicy权限,例如,Compute Engine 实例具有compute.googleapis.com/instances.setIamPolicy权限。如需阻止用户修改这些资源的允许政策,请将这些权限添加到拒绝政策中。如需查看以
setIamPolicy结尾的可拒绝权限的完整列表,请前往拒绝政策中支持的权限并搜索setIamPolicy。iam.googleapis.com/roles.update权限,可让用户修改自定义角色。拥有此权限的用户可以向自定义角色添加权限,从而有效地向自己或他人授予这些权限。
有权修改Unified Access Policies (UAP) 并将其绑定到资源。这些权限如下:
iam.googleapis.com/accesspolicies.update权限,可让用户更新现有 UAP。- 以
createPolicyBinding结尾的权限。对于您可以将 UAP 绑定到的每个资源,都存在这些权限。对于项目、文件夹和组织,这些权限如下:cloudresourcemanager.googleapis.com/projects.createPolicyBindingcloudresourcemanager.googleapis.com/folders.createPolicyBindingcloudresourcemanager.googleapis.com/organizations.createPolicyBinding
或者,您也可以通过在组织中强制执行
iam.managed.disableAccessPolicyBinding组织政策限制条件,阻止所有用户将 UAP 绑定到资源。不过,此组织政策不会阻止用户修改已绑定到资源的现有 UAP。
拒绝访问权限更改
确定要拒绝的权限后,请为您的组织创建拒绝政策,以拒绝这些权限。
控制台
在 Google Cloud 控制台中,前往 IAM 页面上的拒绝标签页。
选择您的组织。
点击 创建拒绝访问政策。
在政策名称部分中,通过执行以下操作之一来定义政策 ID:
- 在显示名称字段中,输入政策的显示名称。填写此字段会自动填写 ID 字段。如果您想更改政策的 ID,请更新 ID 字段中的文本。
- 在 ID 字段中,输入政策的 ID。
在拒绝规则部分中,添加一条拒绝规则,以阻止访问权限更改:
在拒绝的主账号字段中,添加要拒绝其访问权限的主账号。如需拒绝所有用户更改权限,请使用值
principalSet://goog/public:all。如需查看您可以使用的值的完整列表,请参阅拒绝政策的主账号标识符。在例外主账号字段中,添加您希望允许授予访问权限的受信任主账号。如需查看您可以使用的值的完整列表,请参阅拒绝政策的主账号标识符。
在拒绝的权限部分中,添加您在确定允许用户授予访问权限的权限中确定的权限。
可选:添加拒绝条件,指定哪些资源受此规则影响。例如,您可以添加条件,以确保政策仅适用于具有
prod标记值的资源。如需详细了解拒绝条件,请参阅拒绝政策中的条件。
点击创建。
gcloud
gcloud iam policies create 命令可为资源创建拒绝政策。
在使用下面的命令数据之前,请先进行以下替换:
POLICY_ID:拒绝政策的标识符。-
ORG_ID:要在其中创建拒绝政策的组织的数字 ID。 -
POLICY_FILE:包含您要设置的拒绝政策的文件。对拒绝政策使用以下格式:{ "displayName": "POLICY_NAME", "rules": [ { "denyRule": { "deniedPrincipals": [ DENIED_PRINCIPALS ], "exceptionPrincipals": [ EXCEPTION_PRINCIPALS ], "deniedPermissions": [ ACCESS_CHANGE_PERMISSIONS ], DENIAL_CONDITION } } ] }
替换以下值:
POLICY_NAME:拒绝政策的显示名称。-
DENIED_PRINCIPALS:要拒绝访问的主账号。如需拒绝所有用户更改权限,请使用值"principalSet://goog/public:all"。如需查看您可以使用的值的完整列表,请参阅拒绝政策的主账号标识符。 -
EXCEPTION_PRINCIPALS:您希望允许其授予访问权限的可信主账号。如需查看您可以使用的值的完整列表,请参阅拒绝政策的主账号标识符。 -
ACCESS_CHANGE_PERMISSIONS:您在确定允许用户授予访问权限的权限中确定的权限。 -
DENIAL_CONDITION:可选。拒绝条件,用于指定哪些资源受此规则影响。例如,您可以添加条件,以确保规则仅适用于具有prod标记值的资源。如需详细了解拒绝条件,请参阅拒绝政策中的条件。
执行以下命令:
Linux、macOS 或 Cloud Shell
gcloud iam policies create POLICY_ID \ --attachment-point=cloudresourcemanager.googleapis.com/organizations/ORG_ID \ --kind=denypolicies \ --policy-file=POLICY_FILE
Windows (PowerShell)
gcloud iam policies create POLICY_ID ` --attachment-point=cloudresourcemanager.googleapis.com/organizations/ORG_ID ` --kind=denypolicies ` --policy-file=POLICY_FILE
Windows (cmd.exe)
gcloud iam policies create POLICY_ID ^ --attachment-point=cloudresourcemanager.googleapis.com/organizations/ORG_ID ^ --kind=denypolicies ^ --policy-file=POLICY_FILE
如果成功,此命令不会返回任何输出。如需输出详细响应,请使用 --format=json 标志。
REST
policies.createPolicy 方法可以为资源创建一个拒绝政策。
在使用任何请求数据之前,请先进行以下替换:
-
ORG_ID:要在其中创建拒绝政策的组织的数字 ID。 POLICY_ID:拒绝政策的标识符。POLICY_NAME:拒绝政策的显示名称。-
DENIED_PRINCIPALS:要拒绝访问的主账号。 如需拒绝所有用户更改权限,请使用值"principalSet://goog/public:all"。如需查看您可以使用的值的完整列表,请参阅拒绝政策的主账号标识符。 -
EXCEPTION_PRINCIPALS:您要允许其授予访问权限的可信主账号。如需查看您可以使用的值的完整列表,请参阅拒绝政策的主账号标识符。 -
ACCESS_CHANGE_PERMISSIONS:您在确定允许用户授予访问权限的权限中确定的权限。 -
DENIAL_CONDITION:可选。拒绝条件,用于指定哪些资源受此规则影响。例如,您可以添加一个条件,以确保该规则仅适用于具有prod标记值的资源。如需详细了解拒绝条件,请参阅拒绝政策中的条件。
HTTP 方法和网址:
POST https://iam.googleapis.com/v2/policies/cloudresourcemanager.googleapis.com%2Forganizations%2FORG_ID/denypolicies?policyId=POLICY_ID
请求 JSON 正文:
{
"displayName": "POLICY_NAME",
"rules": [
{
"denyRule": {
"deniedPrincipals": [
DENIED_PRINCIPALS
],
"exceptionPrincipals": [
EXCEPTION_PRINCIPALS
],
"deniedPermissions": [
ACCESS_CHANGE_PERMISSIONS
],
DENIAL_CONDITION
}
}
]
}
如需发送您的请求,请展开以下选项之一:
您应该收到类似以下内容的 JSON 响应:
{
"name": "policies/cloudresourcemanager.googleapis.com%2Forganizations%2F1234567890123/denypolicies/deny-access-granting/operations/89cb3e508bf1ff01",
"metadata": {
"@type": "type.googleapis.com/google.iam.v2.PolicyOperationMetadata",
"createTime": "2026-10-31T19:06:12.455151Z"
},
"response": {
"@type": "type.googleapis.com/google.iam.v2.Policy",
"name": "policies/cloudresourcemanager.googleapis.com%2Forganizations%2F1234567890123/denypolicies/deny-access-granting",
"uid": "6665c437-a3b2-a018-6934-54dd16d3426e",
"kind": "DenyPolicy",
"displayName": "Deny access change permissions.",
"etag": "MTc3NDU4KjM4OZ0MzU5MjQ5OTI=",
"createTime": "2026-10-31T19:06:12.455151Z",
"updateTime": "2026-10-31T22:26:21.968687Z",
"rules": [
{
"denyRule": {
"deniedPrincipals": [
"principalSet://goog/public:all"
],
"exceptionPrincipals": [
"principalSet://cloudresourcemanager.googleapis.com/organizations/1234567890123/type/ServiceAgent",
"principalSet://goog/group/iam-admins@example.com"
],
"deniedPermissions": [
"cloudresourcemanager.googleapis.com/projects.setIamPolicy",
"cloudresourcemanager.googleapis.com/folders.setIamPolicy",
"cloudresourcemanager.googleapis.com/organizations.setIamPolicy",
"iam.googleapis.com/accesspolicies.update",
"cloudresourcemanager.googleapis.com/projects.createPolicyBinding",
"cloudresourcemanager.googleapis.com/folders.createPolicyBinding",
"cloudresourcemanager.googleapis.com/organizations.createPolicyBinding"
],
"denialCondition": {
"title": "Only for prod resources",
"expression": "resource.matchTag('12345678/env', 'prod')"
}
}
}
]
}
}
该响应用于标识长时间运行的操作。您可以监控长时间运行的操作的状态,以了解其何时完成。如需了解详情,请参阅检查长时间运行的操作的状态。
后续步骤
- 了解如何排查包含拒绝政策的访问权限问题。
- 详细了解如何拒绝访问主账号。