AccessRequest

概述

AccessRequest 是一个命名空间范围的运行时记录,用于对 Connector 的审批门控代理访问。

它将以下内容绑定在一起:

  • 请求访问的主体
  • 目标 Connector
  • 访问所针对的运行时上下文对象

在 Connectors Approval 模型中,AccessPolicy 定义规则,而 AccessRequest 跟踪一次实际的访问尝试。

在大多数情况下,用户不需要手动创建 AccessRequest。当工作负载通过 Connectors CSI Driver 尝试使用 Connector,且尚未拥有所需的 connectors/proxy 权限时,系统会自动创建它。

INFO

请在阅读 Connectors Approval & Permission Gating 和 AccessPolicy 后阅读本文档。

INFO

在本文档中,使用 Connector 是指通过 Connectors Proxy 使用 Connector 的无密钥访问路径,通常是工作负载通过 Connectors CSI Driver 使用 Connector 配置。

这不意味着读取 Connector 对象本身或调用 Connectors API。

AccessRequest 属于 Connector 所在的命名空间,因为它跟踪对某个特定 Connector 的访问。

请求主体和运行时上下文对象可以位于其他命名空间中。当共享 Connector 被项目或租户命名空间中的工作负载使用时,通常就是这种情况。

可用性

AccessRequest 是 Connectors Approval 功能的一部分。

使用此工作流前,请启用:

  • enable-connectors-approval
  • enable-connector-proxy-permissions

有关更多信息,请参阅 Feature Flags。

了解 AccessRequest

它代表什么

AccessRequest 记录一次具体的运行时请求,而不是可复用的策略。

其关键字段包括:

  • spec.subject:请求访问的主体。在审批门控的 CSI 场景中,通常是工作负载的 ServiceAccount。
  • spec.connectorRef:请求访问的是哪个 Connector。所引用的 Connector 始终与 AccessRequest 位于同一命名空间。
  • spec.context.objectRef:此请求绑定到哪个运行时对象。目前仅支持 Pod。

此资源有意面向运行时:

  • 跟踪一个工作负载上下文的审批进度
  • 仅在检查通过后授予临时权限
  • 工作负载上下文结束后即不再具有关联性

它与 AccessPolicy 的关系

AccessPolicy 回答以下问题:

  • 哪些 Connector 需要审批门控访问
  • 哪些检查必须通过
  • 审批通过后应授予哪项权限

AccessRequest 回答的是另一个问题:

  • 对于这个特定的主体、Connector 和 Pod 上下文,访问是否已经获批并完成同步

这就是两份文档之间的主要边界:

  • AccessPolicy 解释可复用的规则
  • AccessRequest 解释该规则的一次运行时评估

当 AccessRequest 首次匹配策略时,控制器会将匹配的 AccessPolicy.spec 条目的快照存储到 status.policies 中。这样,即使原始策略之后发生更改,正在处理的请求仍能保持稳定。

有关策略架构,请参阅 AccessPolicy API Reference。

它的创建和处理方式

典型流程如下:

  1. 工作负载尝试通过 Connectors Proxy 或 Connectors CSI Driver 使用 Connector。
  2. 如果工作负载已经拥有针对该 Connector 和 Pod 上下文所需的 connectors/proxy 权限,则不需要 AccessRequest。
  3. 如果缺少该权限,CSI 流程会创建或复用一个 AccessRequest。
  4. 控制器验证 Pod 上下文,解析目标 Connector,并将 AccessPolicy 资源与 checkGrantedPermission 进行匹配。
  5. 控制器查找匹配的检查资源,例如 ApprovalTask,并将其结果记录在 status.policies[].matchedChecks 中。
  6. 所有匹配的检查通过后,系统会为请求主体创建临时的 Role 和 RoleBinding。
  7. Pod 完成、被删除或 Connector 不再有效时,系统会清理临时权限。

这意味着 AccessRequest 是审批状态与实际 RBAC 权限同步之间的运行时桥梁。

如何计算检查资源的状态

根据检查规则的不同,每个匹配的检查资源会通过以下两种方式之一转换为通过 / 等待 / 拒绝结果:

  • 使用 Rego 脚本时(检查规则中的 state.rego):控制器会评估该脚本,并将 { "object": <the check resource>, "check": <the check rule, including its params> } 作为输入。这就是内置 connectors-approvals-in-pipeline 规则的工作方式,也是强制执行审批者约束(params.approvers)的方式。请参阅限制谁可以批准。

  • 不使用 Rego 脚本时(默认行为):控制器会读取检查资源自身的状态条件。它会查看标准的 Ready / Succeeded 条件,并直接进行映射:

    • 条件为 True → 检查通过(AccessCheckReady = True,原因 Passed);
    • 条件为 False → 检查被拒绝(AccessCheckReady = False,原因 Rejected);
    • 其他情况,或尚不存在此类条件 → 等待(AccessCheckReady = Unknown,原因 Pending)。

    在不使用 Rego 的路径中,检查规则上的 params 不会产生任何影响——审批者约束仅适用于使用 Rego 脚本的检查规则。

升级自定义 Rego 脚本

早期版本将检查资源本身作为输入,因此脚本会在顶层读取它(input.data.…、input.status.…)。请改为通过 input.object 读取——例如,input.data.result 变为 input.object.data.result。

只有自定义脚本会受到影响,并且仅当 enable-connectors-approval 功能标志启用时才会受到影响;内置规则发布时已经完成迁移。

示例

以下示例展示了一个请求的结构:

apiVersion: connectors.alauda.io/v1alpha1
kind: AccessRequest
metadata:
  name: prod-harbor-build-pod-7x9k2
  namespace: connectors-shared
spec:
  subject:
    kind: ServiceAccount
    name: builder
    namespace: cicd
  connectorRef:
    name: prod-harbor
  context:
    objectRef:
      apiVersion: v1
      kind: Pod
      name: build-pod-7x9k2
      namespace: cicd

此示例展示了一个重要模式:

  • AccessRequest 存储在 Connector 命名空间中:connectors-shared
  • 发起请求的 ServiceAccount 位于工作负载命名空间中:cicd
  • 请求绑定到一个 Pod,而不是绑定到将来使用同一 ServiceAccount 的每个 Pod

读取状态

AccessRequest.status 告诉你运行时审批流程当前被阻塞的位置,或流程是否已完成。

重要条件包括:

  • ContextObjectValid:绑定的 Pod 是否仍然存在且仍处于活动状态
  • ConnectorResolved:引用的 Connector 是否仍然存在
  • AccessPolicyMatched:是否有任何与审批相关的 AccessPolicy 匹配此请求
  • AccessCheckReady:匹配的检查是已通过、待处理还是已拒绝
  • AccessPermissionSync:临时权限是否已同步、仍在等待,或已完成清理
  • Ready:根据上述条件得出的整体结果

常见解释:

  • 审批仍在等待:AccessCheckReady = Unknown,原因是 Pending
  • 访问已授予且可用:Ready = True 和 AccessPermissionSync = True,原因是 Synced
  • 访问被拒绝:AccessCheckReady = False,原因是 Rejected
  • 运行时结束后权限已清理:AccessPermissionSync = True,原因是 PermissionCleanUp

运维说明

  • AccessRequest.spec 在创建后不可变。如果主体、Connector 或上下文发生变化,系统会使用其他请求。
  • AccessRequest 通常仅存在于受审批门控的访问场景中。如果没有审批策略匹配,它不会成为可复用的权限记录。
  • 生成的权限同时限定于请求的 Connector 和运行时 Pod 上下文,这有助于实施最小权限。

后续步骤