拒绝允许用户授予访问权限的权限,有助于防止未经授权的提权,并加强安全控制。本文档介绍了如何识别这些权限,并创建拒绝政策,以阻止大多数用户使用这些权限,同时允许受信任的主账号例外。
准备工作
启用 IAM API(如果尚未启用)。
启用 API 所需的角色
如需启用 API,您需要拥有
serviceusage.services.enable权限。如果您创建了项目,则可能已经通过 Owner 角色 (roles/owner) 拥有此权限。否则,您可以通过 Service Usage Admin 角色 (roles/serviceusage.serviceUsageAdmin) 获得此权限。了解如何授予角色。设置身份验证。
选择标签页以了解您打算如何使用本页面上的示例:
控制台
当您使用 Google Cloud 控制台访问 Google Cloud 服务和 API 时,无需设置身份验证。
gcloud
安装 Google Cloud CLI,然后使用联合身份登录 gcloud CLI。 登录后,运行以下命令来初始化 Google Cloud CLI:
gcloud initREST
如需在本地开发环境中使用本页面上的 REST API 示例,请使用您提供给 gcloud CLI 的凭证。
安装 Google Cloud CLI,然后使用联合身份登录 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权限,可让用户修改自定义角色。拥有此权限的用户可以向自定义角色添加权限,从而有效地向自己或他人授予这些权限。
拒绝访问权限更改
确定要拒绝的权限后,请为您的组织创建拒绝政策,以拒绝这些权限。
控制台
在 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://iam.googleapis.com/locations/global/workforcePools/example-pool/group/iam-admins"
],
"deniedPermissions": [
"cloudresourcemanager.googleapis.com/projects.setIamPolicy",
"cloudresourcemanager.googleapis.com/folders.setIamPolicy",
"cloudresourcemanager.googleapis.com/organizations.setIamPolicy"
],
"denialCondition": {
"title": "Only for prod resources",
"expression": "resource.matchTag('12345678/env', 'prod')"
}
}
}
]
}
}
该响应用于标识长时间运行的操作。您可以监控长时间运行的操作的状态,以了解其何时完成。如需了解详情,请参阅检查长时间运行的操作的状态。
后续步骤
- 了解如何排查包含拒绝政策的访问权限问题。
- 详细了解如何拒绝访问主账号。