外观
23 - 一个 YAML 如何拿到集群权限:认证、RBAC 与 Admission Control
摘要
同一个 YAML,管理员能创建,流水线却报 Forbidden;补齐权限后,又被 Webhook 拒绝。原因是 Kubernetes 分别检查调用者身份、操作权限和对象内容。本文沿一次 API 请求解释这三层检查,再用只读角色和 kubectl auth can-i 说明如何检查最小权限,以及为什么权限检查通过仍不保证对象能创建成功。
1. 场景:Forbidden 修好后,为什么还是创建失败
YAML 描述要提交的资源,访问凭据决定谁在提交。API Server 是 Kubernetes 的 API 入口;Pod 是运行容器的基本单位,Namespace(命名空间)用于划分资源范围。下面是一个示例场景:流水线向 shop 命名空间部署 Pod 时,首先收到如下错误:
text
pods is forbidden: User "system:serviceaccount:ci:deployer"
cannot create resource "pods" in API group "" in namespace "shop"错误中的身份是 ci 命名空间下的服务账号 deployer,它要在 shop 中创建 Pod,但缺少相应权限。管理员通过 RoleBinding(角色绑定)补齐权限后,请求又收到如下策略拒绝:
text
admission webhook "policy.example.com" denied the request:
containers must run as non-root第一个失败在 Authorization(授权):这个身份不能执行创建操作。第二个失败在 Admission(准入控制):创建权限已经通过,但 Pod 的容器运行身份不符合非 root 策略。Webhook 是 API Server 调用的外部检查服务。继续增加 RBAC 权限不能解决这个对象策略问题,需要检查 Pod 配置和拒绝它的规则。
2. API 请求安全链
对于一次对象写入,可以先用下面的模型理解职责:Authentication(认证)识别调用者,Authorization 判断操作权限,Admission 修改或检查对象内容,字段校验检查对象是否符合 API 结构要求,最后才持久化到 etcd(集群资源的存储系统)。
图表将在阅读到此处时加载…
图中概括的是对象写入路径,不是所有 API 请求的逐步执行清单。真实内部顺序和阶段细节会随 API 类型与 Kubernetes 版本演进,稳定的排障思路是:先确认身份,再确认动作权限,最后检查对象策略与校验。前一层通过只意味着请求能继续接受检查,不代表后续各层也会通过。
3. Authentication:你是谁
Kubernetes API 可使用客户端证书、Bearer Token(持有者令牌)、OIDC(OpenID Connect,外部身份认证协议)、Webhook 等认证方式。认证机制从凭据中识别身份,供后续授权使用,信息包括:
text
Username
Groups
Extra attributes其中,Username 是用户名,Groups 是所属用户组,Extra attributes 是附加身份属性。Kubernetes 通常不把普通 User(用户)作为 API 对象保存;用户身份由外部认证系统或证书提供。ServiceAccount(服务账号)则是 Namespace 作用域的 Kubernetes 对象,常供 Pod 和自动化使用。账号属于哪个命名空间,与它能操作哪个命名空间是两个问题:前者标识身份,后者由授权决定。
3.1 ServiceAccount 身份格式
text
system:serviceaccount:<namespace>:<name>例如 system:serviceaccount:shop:diagnostics 表示 shop 中的 diagnostics 服务账号。它所属的服务账号组包括:
text
system:serviceaccounts
system:serviceaccounts:<namespace>RBAC 可以向用户名或用户组授予权限。向组授权会影响该组中的身份,因此要检查组的覆盖范围,不能只看单个账号的绑定。
4. Authorization:这个身份能做什么
RBAC(Role-Based Access Control,基于角色的访问控制)把“权限规则”和“把规则授予谁”分开。Role 或 ClusterRole 定义可执行的动作,Binding 将角色关联到主体,也就是用户、组或服务账号。仅创建角色,不会让某个账号自动获得其中的权限。
四类核心对象的范围如下:
- Role:Namespace 内权限规则;
- ClusterRole:集群范围定义的规则,也可被 RoleBinding 引用到某 Namespace;
- RoleBinding:在 Namespace 内把角色授予主体;
- ClusterRoleBinding:集群范围授予 ClusterRole。
4.1 最小只读 Role
下面的完整 Role 清单定义 shop 中的 Pod 只读权限,使用 rbac.authorization.k8s.io/v1 API。这里的“只读”指不授予创建、修改或删除操作,仍需评估 Pod 信息与日志中是否包含敏感内容。
yaml
apiVersion: rbac.authorization.k8s.io/v1
kind: Role
metadata:
name: pod-reader
namespace: shop
rules:
- apiGroups: [""]
resources: ["pods", "pods/log"]
verbs: ["get", "list", "watch"]apiGroups: [""] 表示核心 API 组,resources 指定资源,verbs 指定动作。pods/log 是 Pod 的日志子资源,即附属于 Pod、通过独立 API 路径访问的能力。能读 Pod 不自动代表能读日志;能更新 Deployment(管理 Pod 副本与更新的工作负载对象)也不等于能更新其 Scale(扩缩容)子资源。规则中列出的动作也不意味着每个子资源都提供这些操作接口。
4.2 绑定 ServiceAccount
以下 RoleBinding 把上面的角色授予 shop 中的 diagnostics 服务账号。使用示例前,需要已有 shop 命名空间和该服务账号,并在该命名空间创建前面的 Role。
yaml
apiVersion: rbac.authorization.k8s.io/v1
kind: RoleBinding
metadata:
name: pod-reader
namespace: shop
subjects:
- kind: ServiceAccount
name: diagnostics
namespace: shop
roleRef:
apiGroup: rbac.authorization.k8s.io
kind: Role
name: pod-readersubjects 指定获得权限的主体,roleRef 指定引用的角色。Binding 所在的 shop 决定授权范围,主体中的 namespace 用来定位服务账号。RoleBinding 的 roleRef 不能随意修改;需要更换引用角色时,常见做法是重建 Binding。具体 API 校验以目标版本为准。
5. Resource、API Group 与 Verb
排查权限时,把请求拆成 API Group(API 组)、Resource(资源)、Subresource(子资源)、Verb(动作),并确认 Namespace。规则还可通过 resourceNames 限定对象名称,但具体支持方式取决于操作,不能假设它能约束所有请求。
例如第 1 节的错误已经给出核心 API 组 ""、资源 pods、动作 create 和命名空间 shop。这些信息比“部署失败”更适合直接对应权限规则。常见动作含义如下:
text
get:读取一个对象
list:列举一组对象
watch:持续观察变化
create:创建
update:整体更新
patch:局部更新
delete:删除list secrets 可能返回授权范围内的所有 Secret 内容,风险并不低于逐个 get。Secret 是存放密码、令牌等敏感数据的 API 对象。create pods 也可能通过挂载 Secret、使用高权限 ServiceAccount、hostPath(挂载节点路径)或特权安全上下文间接扩大能力。这取决于可用资源和准入策略;授权评审必须考虑多项权限组合后的效果,不能只按动作名称判断风险。
6. 最小实验:不用真正执行操作验证权限
以下命令使用 Bash 语法,需要已配置测试集群访问凭据的 kubectl。先准备第 4 节的 Role、RoleBinding 和服务账号。kubectl auth can-i 向 API Server 查询授权结果,不实际执行命令中被查询的读取或创建操作,但仍需要访问集群。
--as 属于 Impersonation(模拟身份),调用者自身必须具有相应的 impersonate 权限。没有权限时测试会失败,这不是目标主体权限的直接结论。前三条命令检查的是 shop:diagnostics,与第 1 节的 ci:deployer 是不同身份。
bash
kubectl auth can-i get pods -n shop \
--as system:serviceaccount:shop:diagnostics
kubectl auth can-i get pods/log -n shop \
--as system:serviceaccount:shop:diagnostics
kubectl auth can-i create deployments.apps -n shop \
--as system:serviceaccount:shop:diagnostics预期输出:在上述绑定生效、没有其他绑定额外授予 Deployment 创建权限、且模拟身份查询成功的条件下,前三条命令依次返回 yes、yes、no。这只说明相应动作的授权结果,不检查待创建对象能否通过 Admission 或字段校验。
列出当前身份在 Namespace 中的权限自检结果:
bash
kubectl auth can-i --list -n shop这条命令没有 --as,查询的是当前凭据对应的身份,不能把结果当成 diagnostics 的权限清单。
检查某 Pod 使用哪个 ServiceAccount,将 POD 替换为当前命名空间中已有 Pod 的名称,调用者需要读取该 Pod 的权限:
bash
kubectl get pod POD -o jsonpath='{.spec.serviceAccountName}{"\n"}'7. Admission:对象允许存在吗
授权只回答“你能否创建 Pod”,Admission 继续回答“这个 Pod 内容是否符合策略”。同一身份提交两个不同配置的 Pod,可能一个通过、一个被拒绝,因此需要把权限检查与对象检查分开。
7.1 Mutating Admission
Mutating Admission(变更型准入)可为对象注入或修改字段,例如 Sidecar(同 Pod 中承担辅助工作的容器)、默认 Label(标签)、资源配置。由于对象可能被改变,请求成功后要查看 API Server 最终保存的对象,而不只看提交前 YAML;请求若被拒绝,则结合拒绝原因和准入日志检查,不能假设已有保存结果。
7.2 Validating Admission
Validating Admission(验证型准入)检查对象但不修改它,例如禁止 privileged(特权容器配置)、要求镜像来自可信仓库。字段校验关注 API 对象的结构是否合法,准入策略则可进一步限制结构合法但不符合组织要求的配置。
策略可由内置 Admission Plugin(准入插件)、ValidatingAdmissionPolicy(声明式验证策略)或外部 Webhook 等机制实现。它们的可用性与成熟度随版本变化,应按目标集群确认。
8. Admission Webhook 的调用与风险
外部 Webhook 把策略判断交给另一个服务。API Server 发送 AdmissionReview(包含待检查请求的准入消息),服务返回允许、拒绝,或在变更型 Webhook 中返回 Patch(字段修改补丁)。下图只概括这次交互;单个 Webhook 允许请求后,仍可能有其他准入检查和字段校验,全部通过才会保存对象。
图表将在阅读到此处时加载…
关键配置包括匹配规则、Namespace/Object Selector(按命名空间或对象标签筛选请求)、timeout(超时)、failurePolicy(调用失败策略)和 CA Bundle(用于验证 Webhook 服务证书的 CA 证书集合)。匹配范围决定哪些请求依赖该服务,超时决定这些请求最多等待多久。
- Fail:Webhook 不可达时拒绝请求,安全更严格但可能阻塞集群变更;
- Ignore:Webhook 不可达时放行,可用性更高但策略可能暂时失守。
这里的 Fail/Ignore 处理的是 Webhook 调用失败,不是把策略明确返回的拒绝改成允许。选择取决于策略风险,不能统一推荐。为了减少对 API 写入的影响,Webhook 应设计为高可用、快速且无副作用,并避免拦截自身恢复所需资源:如果服务失效后,恢复它的请求又必须先通过它,就会形成恢复死锁。
9. Pod Security Standards
Pod Security Standards(Pod 安全标准)提供 Privileged、Baseline、Restricted 等策略层级,分别表达较宽松、基线和更严格的安全约束,可通过相应 Admission 机制按 Namespace 执行。它约束 Pod 安全上下文,即容器运行身份、特权和相关安全配置,不替代镜像扫描、NetworkPolicy(网络访问策略)、Secret 管理和运行时检测。
常见 Restricted 要求涉及非 root 运行、Seccomp(系统调用过滤)、Capabilities(拆分后的 Linux 特权能力)等,但精确规则会随版本更新,应查目标版本文档,不能复制旧清单长期不审计。
10. 排查 API 拒绝
先读完整错误,找出拒绝请求的机制,再结合 HTTP 状态码定位。状态码不能单独区分授权与准入拒绝;如果错误明确给出 Webhook 或 Policy 名称,应优先检查该策略。下面的流程用于整理线索,不应把各类错误当成互斥分类。
图表将在阅读到此处时加载…
保留:完整错误、请求 Verb/Resource/Namespace、调用身份、审计事件和 Admission Webhook 日志。不要只截取“denied”一个词。
11. 反例与正例
反例:排障时绑定 cluster-admin
cluster-admin 提供广泛的集群管理权限。若问题源于缺少操作权限,这样做可能让请求通过,却掩盖实际缺少哪项权限,并留下持久高危授权;若问题来自准入策略,增加权限也不保证解决。
正例:从实际 API 动作反推权限
text
记录客户端调用的 Resource/Subresource/Verb
→ 建立 Namespace Role
→ 用 can-i 与真实操作验证
→ 审计是否存在未使用权限
→ 定期回收12. 容易踩的坑
12.1 ServiceAccount 存在就有权限
身份与授权分离。创建账号后,仍要检查适用于该身份和所属组的 Binding,不能由账号存在推断其业务权限。
12.2 ClusterRole 只能用于集群资源
ClusterRole 可由 RoleBinding 在单 Namespace 内授权。检查权限范围时,同时查看角色规则和绑定类型,不能只看角色名称。
12.3 只防 get secrets
list/watch 也可能返回 Secret 内容;创建 Pod、exec(在容器内执行命令)和 impersonate 还可能在相应条件下间接获得敏感能力。检查读取权限之外,还要检查能否通过其他对象或身份访问这些数据。
12.4 Webhook 超时设很长
超时过长会让匹配该 Webhook 的 API 写请求长时间等待,把策略服务故障传播到依赖它的变更操作。应结合匹配范围和失败策略评估影响。
12.5 Mutating 后仍只检查原 YAML
成功写入后的对象可能已被注入字段。提交清单用于说明客户端意图,服务器保存版本用于确认最终配置,两者需要对照。
13. 总结
一次 Kubernetes API 写入要依次证明“你是谁、你能做什么、这个对象是否允许存在”。
可以带走的三个核心要点:
- Authentication 产生身份,RBAC Authorization 判断动作权限,Admission 校验或修改对象。
- 最小权限必须精确到 API Group、Resource、Subresource 和 Verb,并考虑组合提权。
- Admission Webhook 是 API 写路径依赖,策略强度与控制面可用性必须一起设计。
下一篇:Pod CPU、内存都正常,接口为什么仍然慢:云原生可观测性体系。