认证与鉴权:身份 / RBAC / 排障
覆盖考纲 Cluster Architecture, Installation and Configuration(25%) 中「Manage role based access control (RBAC)」。 环境:v1.36.3,kubeadm 集群,apiserver
--authorization-mode=Node,RBAC
核心认知:一条请求的旅程
① kubectl 读 kubeconfig → 找到证书
② 用证书发起 HTTPS 请求到 apiserver
③ apiserver 用 CA 验签 → 提取 CN(用户名)/ O(组)
④ RBAC 查表:这个用户/组有没有对应权限
⑤ 准入控制(写操作才有)
⑥ 从 etcd 读写数据,返回
| 机制 | 回答 | 失败表现 |
|---|---|---|
| 认证(Authentication) | 你是谁 | Unauthorized(401) |
| 授权(Authorization) | 你能干什么 | Forbidden(403) |
| 准入(Admission) | 能不能这么干 | Forbidden / Invalid |
RBAC 只管第二道。
一、认证:K8s 没有"用户"对象
kubectl create user alice ← 不存在
kubectl get users ← 不存在
K8s 不存储用户,只从凭证里提取字符串(用户名 + 组),后续授权基于这两个字符串。
| 身份来源 | 用户名从哪提取 | 有 K8s 对象吗 |
|---|---|---|
| X.509 客户端证书 | CN(用户)/ O(组) | ❌ |
| ServiceAccount token | JWT 里的 system:serviceaccount:<ns>:<name> | ✅ |
| OIDC / Webhook | 外部服务 | ❌ |
kubeadm 默认启用前两种。实测你自己的身份:
kubectl auth whoami
# Username: kubernetes-admin
# Groups: [kubeadm:cluster-admins system:authenticated]
grep client-certificate-data /etc/kubernetes/admin.conf | awk '{print $2}' \
| base64 -d | openssl x509 -noout -subject
# subject=O=kubeadm:cluster-admins, CN=kubernetes-admin
CN = 用户名,O = 组。 apiserver 验签后提取这两个字段作为身份。
所有认证通过的用户自动获得 system:authenticated 组,默认绑定两个 ClusterRole:system:basic-user(查自己权限)+ system:discovery(get /api、/healthz 等非资源 URL)。没有任何 RoleBinding 时:能查自己能干什么、能看 API 长什么样,但看不到任何实际资源。
授权模式 --authorization-mode=Node,RBAC:两个授权器串行,任一放行即通过。Node 授权器给 kubelet 用(硬编码"只能读写本节点"),RBAC 给人/SA 用。
二、kubeconfig 三段
clusters: # apiserver 地址 + CA
users: # 你的证书 + 私钥
contexts: # cluster + user + namespace 的组合
current-context: # 当前用哪个 context
只有 contexts 把 clusters 和 users 组合起来。 kubectl config use-context <name> 就是切身份。
注意:kubeconfig 的 users[].name 只是本地别名,apiserver 不看这个字段,只看证书的 CN。
三、RBAC 四要素
RBAC 把权限拆成两组独立对象:定义权限的(Role / ClusterRole)和授予权限的(RoleBinding / ClusterRoleBinding)。
四个对象
| 对象 | 是什么 | 作用域 | 关键点 |
|---|---|---|---|
Role | 一组权限规则(apiGroups / resources / verbs) | 一个 namespace | 只能授予该 ns 内的资源 |
ClusterRole | 一组权限规则 | 集群级 | 能管集群级资源(nodes / PV);也能被 RoleBinding 引用,此时只在该 ns 生效 |
RoleBinding | 把权限授予 subject | 一个 namespace | 可引用 Role 或 ClusterRole |
ClusterRoleBinding | 把权限授予 subject | 全集群 | 只能引用 ClusterRole |
核心分离原则:Role 回答"有哪些权限",Binding 回答"给谁"。两者独立——只建 Role 不建 Binding,什么都不会发生。
关系与四种组合
图源:Jimmy Song《Kubernetes Handbook》,已存到本站静态目录
文字版(图片不显示时用):
定义权限 授予权限
─────── ────────
ns 级: Role ←引用── RoleBinding ──绑定──→ Subject
集群级: ClusterRole ←引用── ClusterRoleBinding ──绑定──→ Subject
Role + ClusterRoleBinding = 不合法(CRB 只能引用 ClusterRole)
ClusterRole + RoleBinding = 只在该 ns 生效(ClusterRole 当模板用)
四种组合及生效范围:
| 组合 | 权限实际生效范围 |
|---|---|
| Role + RoleBinding | 该 namespace 内 |
| ClusterRole + RoleBinding | 只在该 namespace 内(不是全集群) |
| ClusterRole + ClusterRoleBinding | 全集群 |
| Role + ClusterRoleBinding | 不合法,apiserver 拒绝创建 |
第二种最反直觉:ClusterRole 此时只是权限模板,作用域由 Binding 决定。常用模式——写一个 ClusterRole,给十个 ns 各建一个 RoleBinding。
subject 类型
| subject 类型 | 是什么 | 有对象吗 |
|---|---|---|
ServiceAccount | 集群内程序身份 | ✅ |
User | 人,字符串 | ❌ 匹配证书 CN |
Group | 组,字符串 | ❌ 匹配证书 O |
YAML
apiVersion: rbac.authorization.k8s.io/v1
kind: Role
metadata: { name: pod-reader, namespace: rbac-lab }
rules:
- apiGroups: [""]
resources: ["pods"]
verbs: ["get", "list", "watch"]
---
apiVersion: rbac.authorization.k8s.io/v1
kind: RoleBinding
metadata: { name: dev-sa-pod-reader, namespace: rbac-lab }
subjects:
- kind: ServiceAccount
name: dev-sa
namespace: rbac-lab
roleRef:
kind: Role
name: pod-reader
apiGroup: rbac.authorization.k8s.io
roleRef 不可修改,换绑只能删了重建(或用 auth reconcile)。
命令式(考场常用)
kubectl -n <ns> create role <name> --verb=get,list --resource=pods
kubectl -n <ns> create rolebinding <name> --role=<role> --serviceaccount=<ns>:<sa>
kubectl create clusterrole <name> --verb=get,list --resource=pods
kubectl create clusterrolebinding <name> --clusterrole=<role> --serviceaccount=<ns>:<sa>
四、rules 字段
rules:
- apiGroups: [""] # 哪个 API 组
resources: ["pods"] # 哪种资源
verbs: ["get","list","watch"] # 能做什么
apiGroups 的坑
| 资源 | apiGroup |
|---|---|
| Pod、Service、ConfigMap、Secret、Node、PV、PVC | ""(空字符串) |
| Deployment、StatefulSet | apps |
| Role、ClusterRole、Binding | rbac.authorization.k8s.io |
| Ingress、NetworkPolicy | networking.k8s.io |
给 pods 权限时 apiGroups 必须写 [""],不能省略。
子资源(必须单独授权)
pods/log(看日志)、pods/exec(执行命令)、deployments/scale(扩缩容)。给 pods 的 get 不包括 pods/log。
resourceNames
限定具体对象,只能和 get/update/patch/delete 一起用,不能和 list/watch/create/deletecollection(集合操作)一起。
内置 ClusterRole
| ClusterRole | 包含什么 | 不能干什么 |
|---|---|---|
view | 所有资源的 get/list/watch | 不能看 secrets,不能写 |
edit | view + create/update/delete | 不能管 RBAC |
admin | edit + ns 内 RBAC | 不能管集群级资源 |
cluster-admin | 一切(*) | 没有限制 |
view 不含 secrets 是设计选择——只读不该包括敏感数据。
控制器的典型两层权限
ClusterRole + ClusterRoleBinding → 集群级 list/watch(监听变化)
Role + RoleBinding → ns 级 create/update(操作自己 ns 的资源)
五、验证与排障
kubectl auth whoami # 我是谁
kubectl auth can-i get pods # 我能不能干
kubectl auth can-i get pods --as=<user> # 别人能不能干
kubectl auth can-i --list --as=<user> -n <ns> # 列出全部权限
kubectl auth reconcile -f rbac.yaml # 智能应用 RBAC(比 apply 安全)
auth reconcile vs apply:apply 更新 RoleBinding 时不能改 roleRef(报错),reconcile 能智能处理。CKA 里更新 RBAC 的正确方式。
Forbidden 报错读法
Error from server (Forbidden): pods is forbidden:
User "system:anonymous" cannot list resource "pods" in API group "" in the namespace "default"
四个要素全在一句里:谁、不能做什么 verb、什么资源、在哪个组/命名空间。
Forbidden 的六种成因
| # | 成因 | 典型表现 |
|---|---|---|
| 1 | apiGroups 写错 | 给 pods 写了 ["apps"](应该是 [""]) |
| 2 | resources 写错 | 拼写错、忘了子资源(pods/log) |
| 3 | verbs 写错 | 混淆 get(单个)和 list(集合) |
| 4 | subject 绑错 | SA 名字/ns/kind 写错 |
| 5 | Role 和 Binding 不在同 ns | 跨 ns 引用 Role 不报错但不生效 |
| 6 | ClusterRoleBinding 引用了 Role | 不合法,apiserver 拒绝创建 |
隐形第七因:can-i 返回 yes 但实际 Forbidden——--as 测的身份和 kubectl 实际 context 身份不同。排查:先 kubectl auth whoami。
401 vs 403
| 状态码 | 含义 | 排查方向 |
|---|---|---|
| 401 Unauthorized | 认证失败 | 证书日期、CA、token |
| 403 Forbidden | 权限不足 | Role/Binding 配置 |
踩坑实录
① --as=system:anonymous 的 can-i 不是 no 而是 403
can-i 底层创建 SelfSubjectAccessReview 对象,--as 连带把这个创建动作也变成匿名身份 → 403。查任意用户权限要用 SubjectAccessReview(非 Self 版),由 admin 代提交。
② apiGroups / 子资源写错不报错,权限静默不生效
apiGroups: ["apps"] 配 resources: ["pods"] 不报错,但 pods 在 "" 组 → 匹配不上。给了 pods 的 get 仍然不能 kubectl logs(需要 pods/log)。RBAC 没有 schema 校验,写错只改变行为。
③ kubeconfig 的 user name ≠ apiserver 看到的用户名
kubeconfig 里 users[].name 只是本地别名,apiserver 只看证书 CN。改 user name 不改证书,身份不变。can-i yes 但实际 Forbidden 时,先 kubectl auth whoami 确认当前身份。
④ Role 和 Binding 跨 ns 不生效 + ClusterRoleBinding 不能引用 Role
RoleBinding 在 default ns 引用 kube-system 的 Role → 不报错但不生效。ClusterRoleBinding 引用 Role → apiserver 直接拒绝创建。
复习自测题(答案)
Q1:ClusterRole + RoleBinding 的权限在哪个范围生效? 只在该 RoleBinding 所在的 namespace。ClusterRole 此时只是权限模板,作用域由 Binding 决定。
Q2:给 pods 的 get 权限,能 kubectl logs 吗?
不能。需要 pods/log 子资源的 get 权限,必须单独授权。
Q3:resourceNames 能和 list 一起用吗?
不能。list 是集合操作。只能和 get/update/patch/delete 一起用。
Q4:view 角色能看 secrets 吗?
不能。view 的 rules 里没写 secrets,只读不该包括敏感数据。
Q5:更新 RoleBinding 的 roleRef 用 apply 还是 reconcile?
用 kubectl auth reconcile。apply 不能改 roleRef(报错),reconcile 能智能处理。
速记卡片
# 认证
kubectl auth whoami
# CN = 用户名,O = 组
# RBAC 四要素
kubectl -n <ns> create role <name> --verb=get,list --resource=pods
kubectl -n <ns> create rolebinding <name> --role=<role> --serviceaccount=<ns>:<sa>
# 验证
kubectl auth can-i get pods --as=<user> -n <ns>
kubectl auth can-i --list --as=<user> -n <ns>
# 更新
kubectl auth reconcile -f rbac.yaml # 比 apply 安全
# 判定
# apiGroups: 核心组 "" 不能省
# 子资源: pods/log 必须单独授权
# resourceNames: 不能和 list/watch/create 一起用
# ClusterRole+RoleBinding 只在该 ns;Role+ClusterRoleBinding 不合法
# view 不含 secrets
# 401 = 认证失败,403 = 权限不足