1
0

Kubernetes RBAC安全框架与用户授权实践笔记

2026-11-01
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。

支持与分享

如果这篇文章对你有帮助,欢迎分享给更多人或者给予支持!