Kubernetes RBAC安全框架与用户授权实践笔记
一、K8s 安全框架概述
api-server 对证书认证分三步:
| 步骤 | 含义 | 类比 |
|---|---|---|
| 鉴权(Authentication) | 验证身份,证书相当于「出入证」 | 小区出入证 |
| 授权(Authorization) | 判断能做什么,用 kubeconfig 文件或 token | 单元楼门禁卡 |
| 准入控制(Admission) | 识别并执行访问控制 | 识别门禁卡的设备 |
二、RBAC 三要素
1. 角色(Role / ClusterRole)——「我能干啥」
角色本质是对「哪些资源」授权:
| 类型 | 作用 |
|---|---|
| Role | 控制局部(名称空间)资源 |
| ClusterRole | 控制全局(集群)资源 |
规则字段:
| 字段 | 含义 |
|---|---|
| apiGroups | 资源所属 API 组(apps/v1 的组是 apps;v1 默认核心组 "") |
| resources | 资源列表(必须写全称,不支持简写) |
| verbs | 可执行的操作(get / list / create / update / patch / delete 等) |
2. 主题(Subject)——「我是谁」
| 类型 | 说明 | 体现形式 |
|---|---|---|
| User | 给个人使用 | 证书的 CN 字段,可存为 kubeconfig |
| Group | 给组织使用 | 证书的 O 字段,可存为 kubeconfig |
| ServiceAccount | 服务账号(sa 资源) | 以 Token 形式存储,token 存在 Secret 里 |
3. 角色绑定(Binding)——把角色授权给主题
| 类型 | 作用 |
|---|---|
| RoleBinding | 把局部资源角色绑定给主题 |
| ClusterRoleBinding | 把全局(集群)资源角色绑定给主题 |
三、内置集群角色
| 角色 | 权限 |
|---|---|
| cluster-admin | 超级管理员,集群所有权限 |
| admin | 命名空间内所有读写权限 |
| edit | 大多数对象读写,但不能查看/修改角色和角色绑定 |
| view | 命名空间内大多数对象只读,不能看角色、角色绑定和 secret |
kubectl get clusterroles | grep -v system:
# admin / cluster-admin / edit / view / flannel / kubeadm:get-nodes
system:开头的是系统内部使用;flannel是 CNI 组件安装时创建的,kubeadm:get-nodes是 kubeadm 部署时创建的。
查看 cluster-admin 的规则:所有 apiGroups、resources、verbs 都是 *,还包含 nonResourceURLs。
四、基于 User 的授权流程
1. 安装 cfssl 证书工具
wget http://<下载服务器>/softwares/demo-cfssl-v1.6.5.zip
apt -y install unzip rename
unzip demo-cfssl-v1.6.5.zip
rename 's/_1.6.5_linux_amd64//g' *_1.6.5_linux_amd64
mv cfssl cfssl-certinfo cfssljson /usr/local/bin/
chmod +x /usr/local/bin/cfssl*
cfssl version
2. 编写证书请求
ca-config.json(证书有效期 10 年,87600h):
{
"signing": {
"default": { "expiry": "87600h" },
"profiles": {
"kubernetes": {
"usages": ["signing", "key encipherment", "server auth", "client auth"],
"expiry": "87600h"
}
}
}
}
demo-csr.json(CN 是用户名,O 是组):
{
"CN": "demo",
"hosts": [],
"key": { "algo": "rsa", "size": 2048 },
"names": [
{ "C": "CN", "ST": "BeiJing", "L": "BeiJing", "O": "k8s", "OU": "System" }
]
}
3. 用 api-server 的 CA 签发证书
cfssl gencert \
-ca=/etc/kubernetes/pki/ca.crt \
-ca-key=/etc/kubernetes/pki/ca.key \
-config=ca-config.json \
-profile=kubernetes \
demo-csr.json | cfssljson -bare demo
生成 demo.pem、demo-key.pem、demo.csr。
4. 生成 kubeconfig 授权文件
kubectl config set-cluster demo-class \
--certificate-authority=/etc/kubernetes/pki/ca.crt \
--embed-certs=true \
--server=https://10.0.0.231:6443 \
--kubeconfig=demo-class.kubeconfig
kubectl config set-credentials demo-class \
--client-key=demo-key.pem \
--client-certificate=demo.pem \
--embed-certs=true \
--kubeconfig=demo-class.kubeconfig
kubectl config set-context demo-context \
--cluster=demo-class \
--user=demo-class \
--kubeconfig=demo-class.kubeconfig
kubectl config use-context demo-context --kubeconfig=demo-class.kubeconfig
验证(此时还没授权,会被拒绝):
kubectl get pods --kubeconfig=demo-class.kubeconfig
# Error from server (Forbidden): User "demo" cannot list resource "pods" ...
5. 创建 RBAC 授权策略
apiVersion: rbac.authorization.k8s.io/v1
kind: Role
metadata:
namespace: default
name: demo-custom-role
rules:
- apiGroups: ["", "apps"]
resources: ["pods", "deployments"]
verbs: ["get", "list"]
- apiGroups: ["", "apps"]
resources: ["daemonsets"]
verbs: ["get", "list", "delete"]
---
apiVersion: rbac.authorization.k8s.io/v1
kind: RoleBinding
metadata:
name: demo-rbac
namespace: default
subjects:
- kind: User
name: demo
apiGroup: rbac.authorization.k8s.io
roleRef:
kind: Role
name: demo-custom-role
apiGroup: rbac.authorization.k8s.io
kubectl apply -f rbac.yaml
6. 验证
kubectl get pods --kubeconfig=demo-class.kubeconfig # 可列出
kubectl --kubeconfig=demo-class.kubeconfig get deploy # 可列出
kubectl --kubeconfig=demo-class.kubeconfig get ds # 可列出(默认 namespace)
kubectl --kubeconfig=demo-class.kubeconfig delete pod <pod>
# Forbidden:没有 delete pods 权限
kubectl get pods --kubeconfig=demo-class.kubeconfig -n kube-system
# Forbidden:Role 只能授权 default 名称空间
Role 只能针对某个名称空间的资源授权;要跨名称空间或授权全局资源(如 Node、Namespace),需要使用 ClusterRole + ClusterRoleBinding。