Skip to main content

认证与鉴权:身份 / RBAC / 排障

覆盖考纲 Cluster Architecture, Installation and Configuration(25%) 中「Manage role based access control (RBAC)」。 环境:v1.36.3,kubeadm 集群,apiserver --authorization-mode=Node,RBAC


核心认知:一条请求的旅程​

Kubernetes API 请求安全处理流程

图片来源:Jimmy Song - Kubernetes 认证与鉴权

① kubectl 读 kubeconfig → 找到证书
② 用证书发起 HTTPS 请求到 apiserver
③ apiserver 用 CA 验签 → 提取 CN(用户名)/ O(组)
④ RBAC 查表:这个用户/组有没有对应权限
⑤ 准入控制(写操作才有)
⑥ 从 etcd 读写数据,返回
机制回答失败表现
认证(Authentication)你是谁Unauthorized(401)
授权(Authorization)你能干什么Forbidden(403)
准入(Admission)能不能这么干Forbidden / Invalid

RBAC 只管第二道。


一、认证:K8s 没有"用户"对象​

Kubernetes 用户身份来源

图片来源:Jimmy Song - Kubernetes 认证与鉴权

kubectl create user alice    ← 不存在
kubectl get users ← 不存在

K8s 不存储用户,只从凭证里提取字符串(用户名 + 组),后续授权基于这两个字符串。

身份来源用户名从哪提取有 K8s 对象吗
X.509 客户端证书CN(用户)/ O(组)❌
ServiceAccount tokenJWT 里的 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,什么都不会发生。

关系与四种组合​

RBAC 对象关系

图源:Jimmy Song《Kubernetes Handbook》,已存到本站静态目录

图片来源:Jimmy Song - Kubernetes 认证与鉴权

文字版(图片不显示时用):

         定义权限              授予权限
─────── ────────
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、StatefulSetapps
Role、ClusterRole、Bindingrbac.authorization.k8s.io
Ingress、NetworkPolicynetworking.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,不能写
editview + create/update/delete不能管 RBAC
adminedit + 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 的六种成因​

#成因典型表现
1apiGroups 写错给 pods 写了 ["apps"](应该是 [""])
2resources 写错拼写错、忘了子资源(pods/log)
3verbs 写错混淆 get(单个)和 list(集合)
4subject 绑错SA 名字/ns/kind 写错
5Role 和 Binding 不在同 ns跨 ns 引用 Role 不报错但不生效
6ClusterRoleBinding 引用了 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 = 权限不足