用于精细访问权限的 IAM Conditions
本页面介绍了如何使用 IAM Conditions 限制对连接的访问。
通过 IAM Condition,您可以精细控制 Integration Connectors 资源。默认情况下,Integration Connectors 用户或角色可以对连接执行所有受支持的操作。通过使用 IAM Conditions,您可以限制特定用户或角色只能对连接执行选定操作。例如,您可以限制用户,使其只能修改名称以 test-connection 开头的连接,并且对连接没有其他权限,例如订阅事件或查看架构元数据。
准备工作
Integration Connectors 使用 Google Cloud 的 Identity and Access Management (IAM) 来管理 Integration Connectors 资源的角色和权限。因此,在 IAM 中为您的 Integration Connectors 资源指定或修改条件之前,请先熟悉以下 IAM 概念:
添加 IAM Conditions 条件
如需将 IAM Condition 添加到 Integration Connectors 资源,您需要以下信息:
- 命名资源 URI - Integration Connectors 中的每个资源都有唯一的资源 URI。例如,连接资源的 URI 为
projects/PROJECT_ID/locations/CONNECTION_LOCATION/connections/{connection_name}。如需查看所有可用 URI 的完整列表,请参阅 Integration Connectors REST 资源。 如需精细控制资源的访问权限,您必须根据命名惯例为资源命名。您可以根据需要决定要使用的命名惯例。例如,您可以为营销团队拥有的所有连接添加marketing-一词作为前缀。在此示例中,营销团队连接的资源 URI 将以projects/PROJECT_ID/locations/CONNECTION_LOCATION/connections/marketing-开头。 - 仅父级权限 - 检查资源或其任何子资源是否需要仅父级权限。如需了解详情,请参阅仅父级权限。
- 资源类型 - 您可以根据条件中的资源类型进行过滤,从而进一步缩小资源的范围。Integration Connectors 支持以下资源条件:
资源名称 资源类型 连接 connectors.googleapis.com/Connection ManagedZone connectors.googleapis.com/ManagedZone EndpointAttachment connectors.googleapis.com/EndpointAttachment EventSubscription connectors.googleapis.com/EventSubscription ConnectionSchemaMetadata connectors.googleapis.com/ConnectionSchemaMetadata
示例
下表列出了您可以为 Integration Connectors 用户或角色应用的示例资源条件。
| IAM 资源条件 | 说明 |
|---|---|
(resource.name.startsWith
("projects/PROJECT_ID/locations/CONNECTION_LOCATION/
connections/marketing-") && resource.type == "connectors.googleapis.com/Connection")
|| (resource.type != "connectors.googleapis.com/Connection"
&& resource.name.extract("/operations/{operation}") == "") |
应用此条件的用户或角色只能执行以下操作:
用户无法查看、取消或删除单个长时间运行的操作。如需让用户跟踪操作进度,请参阅让受限用户跟踪操作。 |
(resource.name.startsWith
("projects/PROJECT_ID/locations/CONNECTION_LOCATION/
connections/marketing-") && resource.type == "connectors.googleapis.com/Connection") ||
(resource.name.startsWith ("projects/PROJECT_ID/locations/CONNECTION_LOCATION/
connections/marketing-") && resource.type == "connectors.googleapis.com/ConnectionSchemaMetadata")
|| (resource.type != "connectors.googleapis.com/Connection"
&& resource.type != "connectors.googleapis.com/ConnectionSchemaMetadata"
&& resource.name.extract("/operations/{operation}") == "") |
您向其应用此条件的用户或角色只能执行以下操作:
用户无法查看、取消或删除单个长时间运行的操作。 |
让受限用户跟踪操作
当前述示例中的条件排除操作时,受限用户仍然可以创建、更新和删除他们有权管理的连接,但无法检查由此产生的长时间运行的操作的状态。如果受限用户需要跟踪操作,请向其授予单独的自定义角色(不含条件),该角色仅包含 connectors.operations.get 权限。
拥有此角色的用户可以查看项目中的任何操作,包括他们无法访问的连接的操作。这与用户已经可以查看的连接信息相同,因为他们可以列出所有连接。请勿向访问权限受条件限制的用户授予 connectors.operations.cancel 或 connectors.operations.delete 权限,因为这些权限会让他们能够取消或删除项目中任何连接的操作。
为 Application Integration 服务账号添加 IAM Conditions 条件
您可以将 IAM 条件应用于 Application Integration 服务账号,从而限制该服务账号在集成执行期间可以访问的连接。例如,您可以限制服务账号,使其只能访问名称以 marketing- 开头的连接。如需了解详情,请参阅将 IAM 条件应用于服务账号。
下表列出了您可以为 Application Integration 服务账号应用的示例资源条件。
| IAM 资源条件 | 说明 |
|---|---|
resource.name.startsWith
("projects/PROJECT_ID/locations/CONNECTION_LOCATION/
connections/marketing-") |
您应用此条件的服务账号只能运行名称以 marketing- 开头的连接。 |
后续步骤
浏览 IAM 文档中的以下信息: