Connector 审批与权限控制
概述
Connectors Approval & Permission Gating 保护工作负载实际使用 Connector 的时刻,尤其是在访问通过 Connectors Proxy 进行时。它在正常的 Connector 权限模型之上,增加了基于策略的检查和临时权限授予。
当团队应能够发现某个 Connector,但诸如将内容提升到生产注册表之类的敏感操作必须等待审批时,此功能非常有用。
此功能同时依赖 enable-connectors-approval 和 enable-connector-proxy-permissions。有关标志详情,请参阅 功能标志。
如果未同时启用这些功能标志,则不会激活特定于审批的流程。
- 如果禁用
enable-connector-proxy-permissions,系统不会应用代理功能权限层,因此审批无法控制代理使用。 - 如果禁用
enable-connectors-approval,系统不会创建或评估特定于审批的运行时流程。
在这种情况下,工作负载使用正常的 Connector 访问模型,而不是受审批控制的代理访问。
请在阅读 Connector 权限模型 后阅读本文档。
本文档从系统层面介绍此功能:
- 为什么要在代理访问之上添加审批
AccessPolicy和AccessRequest如何协同工作- 典型的受审批控制的运行时流程是什么样的
有关资源级别的详细信息,请继续阅读 AccessPolicy,然后阅读 AccessRequest。
在权限模型中的位置
此功能不会取代 Connector 资源级别与权限 中所述的正常 Connector 可见性和范围规则。相反,它会在运行时使用周围增加一道额外的控制门。
实际上,这意味着以下两点可以同时成立:
- 用户可以读取 Connector,或通过
Connectors API使用正常权限模型已允许的受限 API - 在审批检查通过之前,同一个工作负载仍可能被阻止通过
Connectors Proxy使用 Connector。
当浏览或选择 Connector 是可接受的,但应更严格地控制通过该 Connector 执行的实际操作时,这种分离非常有用。
两个核心资源
AccessPolicy 回答“这里应适用什么审批和权限规则?”
AccessRequest 回答“此工作负载现在可以使用该 Connector 吗?”
这种分离是有意设计的:
- 如果你想了解整体功能和端到端流程,请继续阅读本文档
- 如果你需要设计长期有效的规则,请继续阅读 AccessPolicy
- 如果你需要检查某个运行时请求或排查状态问题,请继续阅读 AccessRequest
了解访问模型
在此功能中,管理员在 AccessPolicy 中定义访问模型,系统则通过 AccessRequest 评估每次运行时使用。
从较高层面来看,允许工作负载通过 Connectors Proxy 使用 Connector,通常有两种方式:
defaultPermission:匹配的工作负载可以立即使用 ConnectorcheckGrantedPermission:匹配的工作负载只有在所需检查通过后才能使用 Connector
这意味着,根据风险级别,可以采用不同方式使用同一个 Connector 功能:
- 对于共享的内部工具,管理员可以授予
defaultPermission,让经过批准的命名空间或 ServiceAccounts 直接使用它 - 对于生产注册表或生产集群,管理员可以要求先通过检查,然后才允许工作负载使用 Connector
在运行时,工作负载通常会通过 Connectors CSI Driver 挂载 Connector 配置,然后调用 Connector 的代理端点。如果匹配的策略要求审批,系统会让工作负载保持等待状态,直到检查通过,然后为该工作负载授予临时代理权限。如果检查被拒绝,CSI Driver 只会挂载一个 .error.json 文件(不挂载配置文件),Pod 会在没有可用 Connector 配置的情况下启动,从而使工作负载迅速失败。
实际受控的内容
此功能旨在控制对 Connectors Proxy 的使用,而不是控制读取 Connector 对象本身的能力。
这一点很重要,因为代理访问通常是系统注入工具凭证或允许针对目标系统执行敏感操作的环节。
典型示例包括:
- 将工作负载部署到受保护的 k8s 集群
- 将构件提升到生产注册表
- 运行只有在检查通过后才能使用共享 Connector 的工作负载
授予的权限限定在特定工作负载上下文中。与广泛且长期有效的访问权限相比,这降低了凭证重复使用的风险。
策略与请求的关系
AccessPolicy 可重复使用。一个策略可以应用于一个 Connector、一组 Connector,或命名空间中的所有 Connector。
AccessRequest 特定于运行时。它与一个目标 Connector、一个请求主体和一个上下文对象关联。该请求会记录匹配了哪些策略,以及所需检查是否已通过,以便系统决定是否为该工作负载同步受控权限。
二者结合起来,将长期有效的访问设计与短期运行时授权分离开来:
- 使用
AccessPolicy定义审批和权限模型。 - 使用
AccessRequest评估对 Connector 的一次实际使用。
Tekton Pipeline 示例
一种常见场景是,Tekton pipeline 通过类似 prod-harbor 的 Connector,将构件提升到生产 Harbor 注册表。
要使用此模式,用户需要按如下方式准备 pipeline:
- 管理员为敏感 Connector 定义一个
AccessPolicy,例如prod-harbor。 - pipeline 定义在提升任务之前包含一个
ApprovalTask。 - 提升任务通过 CSI 挂载 Connector,然后使用受保护的代理路径访问目标工具。
此处,受保护的代理路径是指工作负载通过 Connector 访问目标工具时使用的 Connectors Proxy 访问路径。
之后,系统会自动处理支持审批的访问流程:
- 系统会为运行提升任务的 Pod 创建一个
AccessRequest。 - 默认情况下,
AccessRequest会在同一个PipelineRun中查找ApprovalTask。 - 如果该
ApprovalTask已获批准,系统会授予临时代理权限,提升任务继续执行。 - 如果该
ApprovalTask被拒绝,CSI Driver 会挂载一个.error.json文件,而不是配置文件;由于无法访问 Connector,工作负载会失败。 - 如果该
ApprovalTask仍处于待处理状态,工作负载会保持等待,直到作出审批决定。
此模式使团队能够在平台中保留 Connector,同时仍要求在敏感的提升操作使用该 Connector 之前完成明确的审批步骤。
此模式的典型 AccessPolicy 如下:
在此示例中,策略针对一个敏感 Connector,并且仅在当前 pipeline 的 ApprovalTask 获得批准后,才向 Pod 授予代理访问权限。
所引用的两个 ConfigMap 是 Connectors 组件提供的内置模板:
connectors-approvals-in-pipeline定义默认检查规则,用于匹配同一PipelineRun中的ApprovalTaskconnectors-use-connectors-proxy-in-pod定义审批后授予 Pod 的临时代理权限
限制谁可以批准
默认情况下,connectors-approvals-in-pipeline 检查会将 PipelineRun 中任何已批准的
ApprovalTask 视为满足条件。要集中管理审批规则,并要求特定人员或组进行审批,而不是仅在每个 pipeline 的
ApprovalTask 中指定审批人,请将 params 添加到检查规则中:
支持的参数:
approvers— 此策略接受其审批的身份。普通条目(例如alice)匹配审批用户;以group:为前缀的条目(例如group:ops-leads)匹配审批组,并且每个审批组成员都会单独计数。如果省略approvers,则保留旧行为:任何已批准的ApprovalTask都会通过。numberOfApprovalsRequired—approvers中不同已批准身份的最小数量(默认为1)。只有与approvers一起使用时才有意义。
审批决定会根据 ApprovalTask 记录的审批人响应(status.approversResponse)进行验证,而不是根据 pipeline 中声明的审批人列表进行验证。这意味着,即使 pipeline 作者在 ApprovalTask 上设置了不同的审批人列表,审批人约束仍会生效 — 审批人身份由 AccessPolicy 决定,而不是由触发 pipeline 的人员决定。
请求者看到的内容
- 由指定审批人批准 — 检查通过,系统会授予临时代理权限,并在匹配的检查中通过
status.policies[].matchedChecks[].approvedBy记录审批身份。 - 由不在
approvers中的人员批准 — 检查失败,原因是ApproverMismatch,且不会授予任何权限,即使ApprovalTask本身显示为approved。由于进入approved的ApprovalTask已是最终状态,错误审批人的情况无法通过后续审批恢复;必须重新运行工作负载,以创建新的AccessRequest,然后由指定审批人批准。匹配的检查消息会明确说明哪些身份已批准,以及策略要求哪些身份。
典型用例
- 必须等待人工批准的生产制品提升
- 仅在获得批准后将工作负载部署到生产集群
- 部署到受保护的环境,其中必须控制代理访问权限
- 仅应在获得批准后由特定工作负载运行使用的共享 Connectors