Unified Access Policies

Unified Access Policies (UAP) 可让您授予和拒绝Google Cloud 资源的访问权限。与允许和拒绝政策不同,UAP 允许您在同一政策中授予和拒绝访问权限,从而简化政策管理。UAP 还可以重复使用,这意味着您可以将同一 UAP 应用于多个资源。

Unified Access Policies 的工作原理

如需在 IAM 中授予或拒绝访问权限,您需要指定应允许或不允许谁对哪个资源执行什么操作。

在 UAP 中,您可以通过创建 UAP 规则来指定应允许或不允许谁执行什么操作。每条规则都列出了一组主账号、一组角色和权限以及一个效果。效果(允许或拒绝)指定是否向列出的主账号授予规则中的角色和权限,或阻止其使用规则中的权限。一个 UAP 中最多可以有 100 条规则。

如需指定 UAP 控制对哪个资源的访问权限,您可以使用 UAP 绑定将 UAP 绑定到资源。您最多可以将一个 UAP 绑定到 5 个资源。单个资源最多可以绑定 5 项政策。

使用场景

在 IAM 中,您可以使用多种政策类型来允许和拒绝访问:

  • 如需允许访问,您可以使用允许政策或 UAP 允许规则。
  • 如需拒绝访问,您可以使用拒绝政策或 UAP 拒绝规则。

如果您已使用允许或拒绝政策来控制访问权限,我们建议您继续使用这些政策。政策问题排查工具也支持这些政策类型,这有助于更轻松地了解访问错误的根本原因。

UAP 适用于以下情况:

  • 您正在设置一个新组织,并计划使用 UAP 来控制对整个组织的访问。
  • 您希望使用 UAP 条件设置精细访问权限控制。

Unified Access Policies 规则

UAP 由允许和拒绝规则组成。这些规则包含以下组件:

  • 效果:规则是授予访问权限还是拒绝访问。授予访问权限的规则称为“允许规则”。拒绝访问权限的规则称为拒绝规则。

  • 一组主账号:您要添加到规则中的主账号,例如用户、群组或服务账号。在允许规则中,这些主账号会被授予访问权限。在拒绝规则中,这些主账号会被拒绝访问。

  • 角色和权限列表:您要在规则中包含的角色和权限。在允许规则中,系统会授予这些权限。在拒绝规则中,这些权限会被拒绝。

  • 可选:条件表达式:一个 IAM Conditions 表达式,用于指定应用规则时必须满足的条件。如需了解详情,请参阅本页面上的 UAP 中的条件。

Unified Access Policies 规则中的主体

如需指定要包含在规则中的主账号,请定义以下内容:

  • 包含的主账号:您要包含在规则中的主账号。
  • 排除的主账号:您希望从规则中排除的主账号,即使这些主账号位于包含的主账号列表中的群组内。

通过这两个列表,您可以简明地指定要包含在规则中的主账号。例如,假设您要创建一条允许规则,向 example.com 中的用户授予访问权限。如果您想向群组 all@example.com 中的所有人(用户 reduced-access@example.com 除外)授予访问权限,则需要将 all@example.com 添加到包含的主账号列表中,并将 reduced-access@example.com 添加到排除的主账号列表中。

Unified Access Policies 规则中的角色和权限

如需创建要包含在规则中的确切权限列表,请定义以下内容:

  • 包含的权限:您要在规则中包含的权限。
  • 排除的权限:您不希望包含在规则中的权限,即使这些权限位于包含的权限列表中的角色或权限组中也是如此。

如需向所含权限或排除的权限列表中添加权限,您可以参考以下任一内容:

  • 权限:完全限定域名 (FQDN) 格式的各个权限名称。例如 cloudresourcemanager.googleapis.com/projects.get。

  • 角色(仅限允许规则):预定义角色名称,例如 roles/logging.logsViewer。如果您在规则中包含角色名称,则该规则会包含该角色中的所有权限。如需查看角色中的所有权限,请参阅角色和权限参考文档。

    在 UAP JSON 中,这些名称始终以 role: 为前缀,例如 role:roles/logging.logsViewer。

    角色只能在允许规则中使用。任何规则都不支持自定义角色。

  • 权限组:一组权限,例如 aiplatform.googleapis.com/*.*。权限组是与指定模式匹配的权限集。您可以引用的权限组以及这些组中包含的权限存在一些限制。如需了解详情,请参阅本页面上的权限组。

权限组

权限组是与指定模式匹配的权限集。您可以使用权限组来授予或拒绝一组相关权限,例如,您可以拒绝单个服务的所有权限,或授予所有以特定动词结尾的权限。

权限组在允许规则和拒绝规则中的运作方式不同。以下部分介绍了如何在每种规则类型中使用权限组。

允许规则中的权限组

如需在允许规则中标识权限组,请将权限名称的一个或多个部分替换为通配符字符 (*)。每个组包含的权限取决于通配符的位置:

  • 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

在查看允许规则的权限组时,您可以使用这种相似性在两种格式之间进行转换。

此规则有一些例外情况。如需查看这些例外情况,请查看拒绝政策中支持的权限列表,并在过滤条件字段中搜索 IAM v1 API。

拒绝规则中的权限组

拒绝规则仅支持某些权限组。拒绝政策中支持的权限列出了受支持的权限组。受支持的权限组的标识符会将权限名称的一个或多个部分替换为通配符字符 (*)。每个组包含的权限取决于通配符的位置:

  • SERVICE_FQDN/RESOURCE.*:拒绝指定资源的所有权限。
  • SERVICE_FQDN/*.*:拒绝指定服务的所有权限。
  • SERVICE_FQDN/*.VERB:拒绝以指定动词结尾的所有服务权限。

权限组包含当前和未来与指定模式匹配的所有权限。例如,假设您使用权限组 example.googleapis.com/exampleResource.* 来拒绝用户具有 exampleResource 资源类型的所有权限。如果 example.googleapis.com 添加了针对 exampleResource 资源类型的新权限(例如 example.googleapis.com/exampleResource.newPermission),则系统会自动拒绝用户具有新权限。

您只能在受支持的权限组中使用通配符。不支持在拒绝规则中的其他权限名称中使用通配符。

创建 Unified Access Policies

您可以在项目、文件夹或组织中创建 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 Editor 角色 (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 Editor 角色中的权限来访问 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 会由资源的后代继承。

通过政策继承,您只需一次绑定即可将政策应用于大量资源。例如,假设您创建了一个 UAP,该 UAP 为 taylor@example.com 授予 Compute Engine Admin 角色 (roles/compute.admin)。该 UAP 还拒绝 noam@example.com 拥有 compute.googleapis.com/instances.delete 权限。

您希望此 UAP 对组织 example.com 中的所有资源生效。为此,您需要将此 UAP 绑定到组织资源。将 UAP 绑定到组织后,该 UAP 将由该组织中的所有资源继承。

将 UAP 绑定到组织会产生以下影响:

  • taylor@example.com 可以使用 Compute Engine Admin 角色中的权限访问 example.com 中的任何资源。
  • noam@example.com 无法对 example.com 中的任何资源使用 compute.googleapis.com/instances.delete 权限,即使后代资源上的 UAP 授予了他们访问权限也是如此。

如果您希望 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。

已删除的 Unified Access Policies 的绑定

通常,您必须先删除 UAP 的绑定,然后才能删除 UAP。尝试删除具有现有绑定的 UAP 会导致错误。

但是,如果您想在不删除现有绑定的情况下删除 UAP,则可以强制删除 UAP。

强制删除 UAP 会将其从其绑定的所有资源中移除。引用 UAP 的任何绑定最终都会被删除。不过,在删除之前,这些绑定仍会计入可引用单个资源的绑定数量上限。

Unified Access Policies 中的条件

通过 IAM Conditions,您可以为 Google Cloud 资源定义和强制执行基于属性的条件式访问权限控制。在 UAP 中,您可以向各个规则添加条件,以控制这些规则的应用时机。您无法向 UAP 绑定添加条件。

条件由标题、说明和布尔表达式组成。如果表达式对请求的求值结果为 true,则该规则适用于该请求。如果计算结果为 false,则该规则不适用于请求。

不同的服务提供不同的属性和函数,您可以使用这些属性和函数来编写条件表达式。向规则添加条件时,您始终需要在条件前面加上您正在使用的属性和函数的服务名称。您可以向规则添加多个条件,但单个条件不能混合来自不同服务的属性。

例如,如果您要添加使用 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 目标属性

后续步骤