AccessRequest
概述
AccessRequest 是一种命名空间范围的运行时记录,用于对 Connector 的需审批代理访问。
它将以下内容关联起来:
- 请求访问的主体
- 目标
Connector - 请求访问所针对的运行时上下文对象
在 Connectors Approval 模型中,AccessPolicy 定义规则,而 AccessRequest 则跟踪一次实际的访问尝试。
在大多数情况下,用户不需要手动创建 AccessRequest。当工作负载尝试通过 Connectors CSI Driver 使用 Connector,且尚未拥有所需的 connectors/proxy 权限时,系统会自动创建它。
请在阅读 Connectors Approval & Permission Gating 和 AccessPolicy 后再阅读本文档。
在本文档中,使用 Connector 是指通过 Connectors Proxy 使用 Connector 的无密钥访问路径,通常是指工作负载通过 Connectors CSI Driver 消费 Connector 配置。
这不表示读取 Connector 对象本身,也不表示调用 Connectors API。
AccessRequest 属于 Connector 所在的命名空间,因为它跟踪对某个特定 Connector 的访问。
请求主体和运行时上下文对象可以位于其他命名空间中。当共享 Connector 被项目或租户命名空间中的工作负载使用时,通常就是这种情况。
可用性
AccessRequest 是 Connectors Approval 功能的一部分。
使用此工作流前,请启用:
enable-connectors-approvalenable-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。
它的创建和处理方式
典型流程如下:
- 工作负载尝试通过
Connectors Proxy或 Connectors CSI Driver 使用 Connector。 - 如果工作负载已经拥有针对该 Connector 和 Pod 上下文所需的
connectors/proxy权限,则不需要AccessRequest。 - 如果缺少该权限,CSI 流程会创建或复用一个
AccessRequest。 - 控制器会验证 Pod 上下文、解析目标 Connector,并将
AccessPolicy资源与checkGrantedPermission进行匹配。 - 控制器会查找匹配的检查资源(例如
ApprovalTask),并将其结果记录在status.policies[].matchedChecks中。 - 所有匹配的检查通过后,系统会为请求主体创建临时的
Role和RoleBinding。 - 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 脚本的检查规则。 - 条件为
早期版本会将检查资源本身作为输入,因此脚本会在顶层读取它(input.data.…、input.status.…)。请改为通过 input.object 读取——例如,input.data.result 会变为 input.object.data.result。
这只会影响自定义脚本,并且仅在启用 enable-connectors-approval 功能标志时生效;内置规则发布时已经完成迁移。
示例
以下示例展示了一个请求的结构:
此示例展示了一个重要模式:
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 上下文,这有助于实施最小权限。
后续步骤
- 在Connectors 审批与权限控制中重新了解整体流程
- 在AccessPolicy中重新了解策略设计
- 在AccessRequest API 参考中了解架构
- 在AccessPolicy API 参考中了解如何定义审批规则