AccessPolicy
目录
概述可用性了解 AccessPolicy“使用 Connector”的含义AccessPolicy 的工作原理两种访问模型授予默认代理访问权限示例在审批后授予访问权限示例常见配置模式选择要保护的 Connectors示例选择哪些 ServiceAccounts 获得默认访问权限示例状态后续步骤概述
AccessPolicy 是一种命名空间范围的资源,用于控制谁可以通过 Connectors Proxy 使用 Connectors。
它定义了三项内容:
- 策略涵盖哪些 Connectors
- 默认授予代理访问权限,还是仅在检查通过后授予访问权限
- 该访问模型涵盖哪些主体
在 Connectors Approval 模型中,AccessPolicy 是策略定义,而实际的运行时请求则由 AccessRequest 单独跟踪。
请在阅读 Connectors Approval & Permission Gating 后再阅读本文档。
本文档重点介绍管理员设计的长期规则:
- 涵盖哪些 Connectors
- 哪些主体应获得默认代理访问权限
- 在授予临时代理访问权限之前必须通过哪些检查
本文档不会重复介绍某个工作负载的完整运行时生命周期。如需了解相关内容,请继续阅读 AccessRequest。
在此模型中,使用 connector 是指通过 Connectors Proxy 使用 connector 的无密钥访问路径,可以直接使用,也可以通过 Connectors CSI Driver 使用。
AccessPolicy 不控制 Connectors API 访问。Connectors API 使用独立的 connectors/apis 权限,这些权限通常用于 UI 资源发现或其他基于 API 的集成。
可用性
AccessPolicy 是 Connectors Approval 功能的一部分。
使用它之前,请启用:
enable-connectors-approvalenable-connector-proxy-permissions
有关更多信息,请参阅 Feature Flags。
了解 AccessPolicy
“使用 Connector”的含义
AccessPolicy 专注于代理访问,而不是读取 Connector 对象或通过 Connectors API 浏览资源。
使用 connector 的典型示例包括:
- 工作负载向 Connector 的代理地址发送请求
- Pod 通过 Connectors CSI Driver 挂载 Connector 配置,然后通过代理使用目标工具
- 流水线工作负载仅在获得批准后,才获得使用敏感 Connector 的临时权限
不属于 AccessPolicy 范围的典型示例包括:
- 读取
Connector对象本身 - 通过 Connectors API 浏览分支、标签或其他面向 UI 的资源
- 向平台用户授予
Connectors APIs权限
AccessPolicy 的工作原理
AccessPolicy 位于 Connector 定义与运行时访问之间:
Connector:定义如何访问目标工具,以及如何向其进行身份验证AccessPolicy:选择 Connectors,并定义哪些主体可以通过这些 Connectors 提供的 Connectors Proxy 访问目标工具AccessRequest:记录一个需要进行面向批准的评估的运行时访问尝试- 生成的
Role和RoleBinding:系统根据策略模板创建的实例化 RBAC 对象
如果你首先需要了解这些组件如何端到端地协同工作,请参阅 Connectors Approval & Permission Gating。本文档将重点放在策略设计和策略匹配上。
从高层次看,流程如下:
- 工作负载尝试通过
Connectors Proxy或 Connectors CSI Driver 使用 Connector。 - 系统评估匹配的
AccessPolicy。 - 如果策略使用
defaultPermission,并且工作负载的 ServiceAccount 在涵盖范围内,则允许访问。 - 如果策略使用
checkGrantedPermission,系统会在AccessRequest中跟踪此次运行时尝试,并且仅在检查通过后授予配置的代理权限。
有关运行时请求的资源架构,请参阅 AccessRequest API Reference。
两种访问模型
对于一个 Connector,AccessPolicy 通常使用以下两种代理访问模型之一:
Granting Default Proxy Access与defaultPermission:匹配的 ServiceAccounts 可以立即通过 Connector 代理访问目标工具Granting Access After Approval与checkGrantedPermission:运行时请求必须通过检查后,才能授予代理权限
实际上,这意味着通过一个 Connector 进行的访问通常要么在已知范围内始终允许,要么对敏感使用进行审批控制。接下来的两个章节将首先介绍这两种模型,后面的 Common Configuration Patterns 章节则说明如何将它们限定到特定的 Connectors 和 ServiceAccounts。
授予默认代理访问权限
spec.defaultPermission 是策略中用于立即授予代理访问权限、无需进行任何审批检查的部分。
以下情况通常适合使用此方式:
- Connector 在某个 namespace 或项目中风险较低
- 一个范围内的所有工作负载都应直接通过 Connector 代理访问目标工具
- 你希望使用稳定、非临时的权限模型
在大多数情况下,内置的 connectors-use-connectors-proxy 模板是合适的起点。它是由核心 Connectors 组件安装的角色模板,并为匹配的 Connector 授予 connectors/proxy 权限。
当 Connector 应始终可在 namespace、项目或集群范围内使用时,通常只需在策略中配置此权限部分。
有关如何确定此模型涵盖哪些 Connectors 和 ServiceAccounts,请参阅 Common Configuration Patterns。
示例
以下策略会立即向 builder 和 deployer 授予对 devops 中所有 OCI Connectors 的代理访问权限:
在审批后授予访问权限
spec.checkGrantedPermission 仅在所有配置的检查通过后授予代理权限。
以下情况通常适合使用此方式:
- Connector 涉及敏感内容
- 访问权限仅应针对一次运行时活动授予
- 审批是交付或提升工作流的一部分
最常见的内置组合是:
checks[].ref.configMap.name: connectors-approvals-in-pipelineroleTemplate.ref.configMap.name: connectors-use-connectors-proxy-in-pod
该组合表示:
- 查找与运行时对象关联的审批资源
- 等待审批结果为通过
- 仅向该特定运行时上下文授予 Pod 绑定的代理权限
connectors-approvals-in-pipeline 是由核心 Connectors 组件安装的内置检查模板。在流水线场景中,它使用运行时的 Pod 上下文,通过 tekton.dev/pipelineRun 查找关联的 Tekton ApprovalTask。
connectors-use-connectors-proxy-in-pod 是由核心 Connectors 组件安装的内置角色模板。它授予 connectors/proxy/v1/pod/{.object.metadata.namespace}/{.object.metadata.name},将权限绑定到运行时记录的一个特定 Pod 上下文。
你仍然可以使用 Common Configuration Patterns 中相同的 Connector 选择模式;区别在于,访问权限会在检查成功后,针对每个运行时上下文授予。
示例
以下策略应用于 prod-harbor Connector。它不授予默认访问权限,而是等待内置的流水线审批检查,然后授予 Pod 绑定的代理权限。
如需进一步要求由特定人员或组进行审批,请将 params
(例如 approvers 和 numberOfApprovalsRequired)添加到检查规则中。请参阅
Restricting Who Can Approve。
常见配置模式
选择要保护的 Connectors
AccessPolicy 仅匹配与策略本身位于同一命名空间中的 Connectors。
目标 Connectors 在 spec.connector 中定义:
- 留空以匹配命名空间中的所有 Connectors
- 使用
names以指定特定的 Connectors - 使用
matchLabels或matchExpressions以指定 Connector 组
这是将一个策略映射到某个范围内的一个 Connector、Connector 子集或所有 Connectors 的主要机制。
示例
-
匹配当前命名空间中的所有 Connectors。
-
按名称匹配一个特定的 Connector。
-
匹配一个命名空间中多个明确指定名称的 Connectors。
-
匹配命名空间中属于某个 ConnectorClass 的每个 Connector。
-
通过环境或用途等自定义标签匹配 Connectors 子集。
选择哪些 ServiceAccounts 获得默认访问权限
使用 defaultPermission 时,bindingTemplate.serviceAccounts 定义哪些 ServiceAccounts 可以通过 Connectors Proxy 使用匹配的 Connector。
每个条目包含:
names:要绑定的 ServiceAccount 名称namespaceSelector:这些 ServiceAccounts 所属的命名空间
如果希望选定命名空间中的所有 ServiceAccounts,使用空的 names 列表。
示例
-
允许当前命名空间中的所有 ServiceAccounts。这是命名空间级 Connector 的常见模式。
-
仅允许一个命名空间中选定的 ServiceAccounts,例如
devops中的builder和deployer。 -
允许一个项目中的所有 ServiceAccounts。当 Connector 在项目级别共享,且项目命名空间使用
cpaas.io/project添加标签时,此方式非常有用。 -
允许一个项目中所有命名空间内的一个指定名称的 ServiceAccount,例如
devops项目中的builder。 -
允许集群中的所有 ServiceAccounts。这对于集群共享的 Connector 非常有用。在这种情况下,必须在与共享 Connector 相同的命名空间中创建
AccessPolicy。
状态
AccessPolicy.status 可帮助 operator 确认策略是否已按预期应用。
重要的状态字段包括:
matchedConnectors:当前与spec.connector匹配的 Connectorsconditions:策略的协调状态
此状态有助于在调查运行时访问行为之前,检查是否已选择预期的 Connectors。
后续步骤
- 了解如何在 AccessRequest 中评估单个运行时请求
- 在 AccessPolicy API Reference 中了解架构
- 在 Connectors Approval & Permission Gating 中重新了解整体流程
- 在 Connectors Proxy 中了解代理流量的工作方式
- 了解工作负载如何通过 Connectors CSI Driver 使用 Connectors
- 在 Connector API 中了解独立的 API 访问模型