Connector 审批与权限门控

概述

Connectors Approval & Permission Gating 保护工作负载实际使用 Connector 的时刻,尤其是在通过 Connectors Proxy 访问时。它在常规 Connector 权限模型之上增加了基于策略的检查和临时权限授予。

当团队应能够发现某个 Connector,但诸如将内容提升到生产 registry 之类的敏感操作必须等待审批时,此功能非常有用。

此功能同时依赖 enable-connectors-approval 和 enable-connector-proxy-permissions。有关标志的详细信息,请参阅功能标志。

如果未同时启用这些功能标志,则不会启用特定于审批的流程。

  • 如果禁用 enable-connector-proxy-permissions,系统不会应用代理功能权限层,因此审批无法对代理使用进行门控。
  • 如果禁用 enable-connectors-approval,系统不会创建或评估特定于审批的运行时流程。

在这种情况下,工作负载使用常规 Connector 访问模型,而不是受审批门控的代理访问。

INFO

请先阅读 Connector 权限模型,再阅读本文档。

本文档从系统层面介绍此功能:

  • 为什么要在代理访问之上增加审批
  • AccessPolicy 和 AccessRequest 如何协同工作
  • 典型的受审批门控运行时流程是什么样的

有关资源级别的详细信息,请继续阅读 AccessPolicy,然后阅读 AccessRequest。

它在权限模型中的位置

此功能不会取代 Connector 资源级别和权限 中所述的常规 Connector 可见性和范围规则。相反,它会在运行时使用周围增加一道额外的门控。

实际上,这意味着以下两点可以同时成立:

  • 用户可以读取 Connector,或通过 Connectors API 使用常规权限模型已允许的有限 API
  • 在审批检查通过之前,同一工作负载仍可能无法通过 Connectors Proxy 使用该 Connector。

当浏览或选择 Connector 是可接受的,但应更加严格地控制通过该 Connector 执行实际操作时,这种分离非常有用。

两个核心资源

资源在流程中的作用
AccessPolicy长期有效的规则,用于定义涵盖哪些 Connector、默认授予哪些访问权限,以及哪些访问需要检查。
AccessRequest某个工作负载尝试使用某个 Connector 时的运行时记录,其中包括匹配的策略、检查结果和临时权限状态。

AccessPolicy 回答“这里应应用哪条审批和权限规则?”

AccessRequest 回答“此工作负载现在可以使用该 Connector 吗?”

这种分离是有意设计的:

  • 如果你想了解整体功能和端到端流程,请继续阅读本文档
  • 如果你需要设计长期有效的规则,请继续阅读 AccessPolicy
  • 如果你需要检查某个运行时请求或排查状态问题,请继续阅读 AccessRequest

了解访问模型

在此功能中,管理员在 AccessPolicy 中定义访问模型,系统则通过 AccessRequest 评估每次运行时使用请求。

从较高层面来看,允许工作负载通过 Connectors Proxy 使用 Connector 通常有两种方式:

  • defaultPermission:匹配的工作负载可以立即使用 Connector
  • checkGrantedPermission:匹配的工作负载只有在所需检查通过后才能使用 Connector

这意味着,根据风险级别,同一 Connector 功能可以有不同的使用方式:

  • 对于共享的内部工具,管理员可以授予 defaultPermission,使已批准的命名空间或 ServiceAccounts 可以直接使用它
  • 对于生产 registry 或生产集群,管理员可以要求先通过检查,之后才允许工作负载使用 Connector

在运行时,工作负载通常会通过 Connectors CSI Driver 挂载 Connector 配置,然后调用 Connector 的代理端点。如果匹配的策略要求审批,系统会让工作负载保持等待状态,直到检查通过,然后为该工作负载授予临时代理权限。如果检查被拒绝,CSI Driver 只会挂载一个 .error.json 文件(不挂载配置文件),Pod 会在没有可用 Connector 配置的情况下启动,从而使工作负载快速失败。

实际受限的内容

此功能旨在限制 Connectors Proxy 的使用,而不是限制读取 Connector 对象本身的能力。

这一点很重要,因为代理访问通常是系统注入工具凭证或允许对目标系统执行敏感操作的环节。

典型示例包括:

  • 将工作负载部署到受保护的 k8s 集群
  • 将构件提升到生产 registry
  • 仅在检查通过后运行应使用共享 Connector 的工作负载

授予的权限限定在特定工作负载上下文中。与广泛且长期有效的访问相比,这可以降低凭证重复使用的风险。

策略与请求的关系

AccessPolicy 可重复使用。一个策略可以应用于一个 Connector、一组 Connectors,或命名空间中的所有 Connectors。

AccessRequest 特定于运行时。它与一个目标 Connector、一个请求主体和一个上下文对象相关联。请求会记录哪些策略匹配,以及所需检查是否已通过,以便系统决定是否为该工作负载同步受限权限。

二者共同将长期有效的访问设计与短期运行时授权分离开来:

  • 使用 AccessPolicy 定义审批和权限模型。
  • 使用 AccessRequest 评估一次实际的 Connector 使用请求。

Tekton Pipeline 示例

一个常见场景是,Tekton Pipeline 通过类似 prod-harbor 的 Connector 将构件提升到生产 Harbor registry。

要使用此模式,用户需要按如下方式准备 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 如下:

apiVersion: connectors.alauda.io/v1alpha1
kind: AccessPolicy
metadata:
  name: prod-harbor-approval
  namespace: devops
spec:
  connector:
    names:
      - prod-harbor
  checkGrantedPermission:
    spec:
      checks:
        - name: manual-approval
          ref:
            configMap:
              name: connectors-approvals-in-pipeline
      roleTemplate:
        ref:
          configMap:
            name: connectors-use-connectors-proxy-in-pod

在此示例中,策略针对一个敏感 Connector,并且仅在当前 Pipeline 的 ApprovalTask 获得批准后,才向 Pod 授予代理访问权限。

引用的两个 ConfigMap 是 Connectors 组件提供的内置模板:

  • connectors-approvals-in-pipeline 定义默认检查规则,用于匹配同一 PipelineRun 中的 ApprovalTask
  • connectors-use-connectors-proxy-in-pod 定义审批后授予 Pod 的临时代理权限

限制谁可以批准

默认情况下,connectors-approvals-in-pipeline 检查会将 PipelineRun 中任何已批准的 ApprovalTask 视为满足条件。要集中管理审批规则,并要求由特定人员或群组进行批准,而不是仅在每个 Pipeline 的 ApprovalTask 中指定审批人,请将 params 添加到检查规则中:

checkGrantedPermission:
  spec:
    checks:
      - name: manual-approval
        ref:
          configMap:
            name: connectors-approvals-in-pipeline
        params:
          - name: approvers
            value: ["alice", "group:ops-leads"]
          - name: numberOfApprovalsRequired
            value: 2
    roleTemplate:
      ref:
        configMap:
          name: connectors-use-connectors-proxy-in-pod

支持的参数:

  • 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

后续步骤