禁止用户授予访问权限

拒绝允许用户授予访问权限的权限,有助于防止未经授权的提权,并加强安全控制。本文档介绍了如何识别这些权限,并创建拒绝政策,以阻止大多数用户使用这些权限,同时允许受信任的主账号例外。

准备工作

  • 启用 IAM API(如果尚未启用)。

    启用 API 所需的角色

    如需启用 API,您需要拥有 serviceusage.services.enable 权限。如果您创建了项目,则可能已经通过 Owner 角色 (roles/owner) 拥有此权限。否则,您可以通过 Service Usage Admin 角色 (roles/serviceusage.serviceUsageAdmin) 获得此权限。了解如何授予角色。

    启用 API

  • 设置身份验证。

    选择标签页以了解您打算如何使用本页面上的示例:

    控制台

    当您使用 Google Cloud 控制台访问 Google Cloud 服务和 API 时,无需设置身份验证。

    gcloud

    安装 Google Cloud CLI,然后使用联合身份登录 gcloud CLI。 登录后,运行以下命令来初始化 Google Cloud CLI:

    gcloud init

    REST

    如需在本地开发环境中使用本页面上的 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.setIamPolicy
    • cloudresourcemanager.googleapis.com/folders.setIamPolicy
    • cloudresourcemanager.googleapis.com/organizations.setIamPolicy

    其他资源也具有 setIamPolicy 权限,例如,Compute Engine 实例具有 compute.googleapis.com/instances.setIamPolicy 权限。如需阻止用户修改这些资源的允许政策,请将这些权限添加到拒绝政策中。

    如需查看以 setIamPolicy 结尾的可拒绝权限的完整列表,请前往拒绝政策中支持的权限并搜索 setIamPolicy。

  • iam.googleapis.com/roles.update 权限,可让用户修改自定义角色。拥有此权限的用户可以向自定义角色添加权限,从而有效地向自己或他人授予这些权限。

拒绝访问权限更改

确定要拒绝的权限后,请为您的组织创建拒绝政策,以拒绝这些权限。

控制台

  1. 在 Google Cloud 控制台中,前往 IAM 页面上的拒绝标签页。

    进入 IAM

  2. 选择您的组织。

  3. 点击 创建拒绝访问政策。

  4. 在政策名称部分中,通过执行以下操作之一来定义政策 ID:

    • 在显示名称字段中,输入政策的显示名称。填写此字段会自动填写 ID 字段。如果您想更改政策的 ID,请更新 ID 字段中的文本。
    • 在 ID 字段中,输入政策的 ID。
  5. 在拒绝规则部分中,添加一条拒绝规则,以阻止访问权限更改:

    1. 在拒绝的主账号字段中,添加要拒绝其访问权限的主账号。如需拒绝所有用户更改权限,请使用值 principalSet://goog/public:all。如需查看您可以使用的值的完整列表,请参阅拒绝政策的主账号标识符。

    2. 在例外主账号字段中,添加您希望允许授予访问权限的受信任主账号。如需查看您可以使用的值的完整列表,请参阅拒绝政策的主账号标识符。

    3. 在拒绝的权限部分中,添加您在确定允许用户授予访问权限的权限中确定的权限。

    4. 可选:添加拒绝条件,指定哪些资源受此规则影响。例如,您可以添加条件,以确保政策仅适用于具有 prod 标记值的资源。如需详细了解拒绝条件,请参阅拒绝政策中的条件。

  6. 点击创建。

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')"
          }
        }
      }
    ]
  }
}

该响应用于标识长时间运行的操作。您可以监控长时间运行的操作的状态,以了解其何时完成。如需了解详情,请参阅检查长时间运行的操作的状态。

后续步骤