K8s RBAC 怎么配?给 ServiceAccount 最小权限,4 步搞定
技术教程 · K8s · 安全与权限 · 2026-09-27
K8s RBAC 怎么配?给 ServiceAccount 最小权限,4 步搞定
同事把一个服务扔上集群,跑起来 Pod 里调 K8s API 报 pods is forbidden: User "system:serviceaccount:dev:app-sa" cannot list resource "pods"。旁边有人接了一句「绑个 cluster-admin 不就行了」。确实能跑起来,但这个 Pod 从此握着整个集群的钥匙。
下面这套流程,4 步就能给它一份刚好够用的权限。
前置准备
-
kubectl,且当前 kubeconfig 有 RBAC 管理权限(能建 Role / RoleBinding)
-
一个用来做实验的 namespace
步骤 1:别用 default,单独建一个 ServiceAccount
kubectl create namespace dev
kubectl create serviceaccount app-sa -n dev
kubectl get sa app-sa -n dev
每个 namespace 都自带一个 default ServiceAccount。Pod 里没写 serviceAccountName,用的就是它。所以给 default 加权限 = 这个 namespace 里所有没指定 SA 的 Pod 一起拿到权限。要授权就给专门的 SA。
步骤 2:写一个最小权限 Role(动词 + 资源 + 名字)
命令行版本:
kubectl create role app-sa-pod-reader -n dev \
--verb=get --verb=list --verb=watch --resource=pods
但更推荐存成 YAML 进 Git(RBAC as code):
apiVersion: rbac.authorization.k8s.io/v1
kind: Role
metadata:
namespace: dev
name: app-sa-pod-reader
rules:
- apiGroups: [""] # "" 表示 core API group,pods/services/configmaps 都在这里
resources: ["pods", "pods/log"]
verbs: ["get", "list", "watch"]
- apiGroups: [""]
resources: ["secrets"]
verbs: ["get"]
resourceNames: ["db-credentials"] # 只允许读这一个 Secret
三个要点:
-
RBAC 权限是纯加法,没有 deny 规则。没写允许的,一律拒绝 —— 所以不用去写「禁止删 Pod」,不写就行。
-
子资源要单独列。pods/log 不在 pods 里。只给 pods 不给 pods/log,kubectl logs 照样 403。(作者补充:这是我被问得最多的一个坑)
-
敏感资源用 resourceNames 收窄。一个 SA 只需要读某个 Secret 时,别整个 secrets 都放给它。
步骤 3:用 RoleBinding 绑定,尽量别用 ClusterRoleBinding
kubectl create rolebinding app-sa-pod-reader \
--role=app-sa-pod-reader \
--serviceaccount=dev:app-sa \
-n dev
Role + RoleBinding 只在一个 namespace 内生效。要跨 namespace 复用,或者想直接用官方内置角色,就用 ClusterRole + RoleBinding 组合 —— 权限定义一次,授权范围仍然锁在某个 namespace:
kubectl create rolebinding app-sa-view \
--clusterrole=view \
--serviceaccount=dev:app-sa \
-n dev
四个内置 ClusterRole 的取舍:
-
cluster-admin:所有资源所有操作。业务 SA 一律别绑。
-
admin:namespace 内绝大多数资源读写,还能建 Role / RoleBinding。
-
edit:大部分资源读写,但不能看改 Role / RoleBinding;不过能读 Secret、能以 namespace 内任意 SA 起 Pod,等于可以提权。
-
view:只读,且看不到 Secret —— 因为读到 Secret 就等于拿到 SA 凭据。
所以给业务的起点应该是 view 或自己写的 Role,别图省事上 admin / edit。
步骤 4:验证 —— kubectl auth can-i
kubectl auth can-i list pods \
--as=system:serviceaccount:dev:app-sa -n dev # yes
kubectl auth can-i delete pods \
--as=system:serviceaccount:dev:app-sa -n dev # no
kubectl auth can-i --list \
--as=system:serviceaccount:dev:app-sa -n dev # 完整权限清单
遇到 403 的排查顺序:
-
- 先看报错里的 User。system:serviceaccount:dev:app-sa 这个格式直接读得出 namespace 和 SA 名,先确认它是不是你以为的那个 SA(很多 403 是 SA 名字写错,或者 workload 用的是 default)。
-
- kubectl auth can-i --list --as=... 看它到底有什么权限。
-
- kubectl describe rolebinding <name> -n dev 确认 subjects 和 roleRef 有没有绑错、绑到别的 namespace。
注意 --as= 是在做身份模拟(impersonate),你自己得有 impersonate 权限,否则这条命令本身就会 403。默认的 admin 角色有,普通只读账号不一定。
常见坑
-
- roleRef 不可变。绑定建好之后想换角色,直接改 YAML 会报校验错误(roleRef 是 immutable 的),必须删掉重建。用 GitOps 就交给 kubectl auth reconcile -f rbac.yaml,它会自动处理 binding 的删除重建;加上 --remove-extra-permissions --remove-extra-subjects 还能顺手清掉有人手工加的权限。
-
- K8s 1.24 起,SA 不再自动生成长期 token Secret。想拿 token 测试别去翻 secret 了,直接 kubectl create token app-sa -n dev(默认有效期 1 小时)。要更可控就用 projected volume 里的 serviceAccountToken,显式写 expirationSeconds 和 audience。
-
- 权限是并集,只会越叠越多。同一个 SA 被多个 binding 绑过,最终权限是它们的合集。排查时别只看你刚改的那一个,逐条查。定期跑 kubectl auth can-i --list --as=... 当审计。
-
- 不用 API 的 workload 就别挂 token。在 SA 或 Pod spec 里设 automountServiceAccountToken: false。少一份 token,少一条被利用的路。
一句话总结
ServiceAccount 是身份,Role 是权限清单,RoleBinding 把两者绑起来;因为 RBAC 只做加法,所以从「一个 SA + 一个 namespace + 一个最小 Role」起步,再用 kubectl auth can-i 验证,比出了事再收权限省力得多。