RBAC原理和用法

1.RBAC的API资源对象说明

RBAC引入了4个新的顶级资源对象:Role、ClusterRole、RoleBinding、ClusterRoleBinding,可以使用kubectl或者API调用等方式操作这些资源对象。

1.角色(Role)

一个角色就是一组权限的集合,这里的权限都是许可形式的,不存在拒绝的规则。在一个命名空间中,用Role来定义一个角色,集群级别的使用ClusterRole。角色只能对命名空间内的资源进行授权。

  • 下面的例子中定义的角色具备读取Pod的权限:
kind: Role
apiVersion: rbac.authorization.k8s.io/v1beta1
metadata:
  name: pod-reader
  namespace: namespace-test
rules:
  - apiGroups:
      - ""     # 空字符串代表核心API群
    resources:
      - "pods"
    verbs:
      - "get"
      - "list"
      - "watch"

# 或者写为:
rules:
  - apiGroups: [""]
    resources: ["pods"]
    verbs: ["get", "list", "watch"]

rules中的参数说明:

  • apiGroup:支持的API组列表,例如:""、APIVersion: batch/v1、APIVersion: extensions:v1、apiVersion:apps/v1等
  • resources:支持的资源对象列表,例如:pods、deployments、jobs、secrets、service、namespace等
  • verbs:对资源对象的操作方法列表,例如:get、watch、list、delete、replace、patch等

2.集群角色(ClusterRole)

集群角色(ClusterRole)除了具有和角色(Role)一致的命名空间内资源的管理能力,因其集群级别的范围,还可以用于以下特殊元素的授权。

  • 集群范围的资源,例如node

  • 非资源型的路径,例如/healthz

  • 包含全部命名空间的资源,例如pods

  • 下面例子的集群角色(ClusterRole)可以让用户有权访问任意一个或所有命名空间的secrets:

kind: ClusterRole
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
  name: secret-reader  # ClusterRole不受限于命名空间,所以省略了namespace name的定义
rules:
- apiGroups: [""]
  resources: ["secrets"]
  verbs: ["get", "list", "watch"]

3.角色绑定(RoleBinding)和集群角色绑定(ClusterRoleBinding)

角色绑定或集群角色绑定用来把一个角色绑定到一个目标上,绑定目标可以是User、Group或者ServiceAccount。使用RoleBinding为某个命名空间授权,ClusterRoleBinding为集群范围内授权。

RoleBinding可以引用Role进行授权,下例中的RoleBinding将在namespace-test命名空间中把pod-reader角色授予用户test,可以让test用户读取namespace-test命名空间的Pod。

kind: RoleBinding
apiVersion: rbac.authorization.k8s.io/v1
metadata:
  name: read-pods
  namespace: namespace-test

subjects:
- kind: User
  name: test
  apiGroup: rbac.authorization.k8s.io
roleRef:
  kind: Role
  name: pod-reader
  apiGroup: rbac.authorization.k8s.io

RoleBinding也可以引用ClusterRole,对属于同一命名空间内ClusterRole定义的资源主体进行授权。一种常见的做法是集群管理员为集群范围预先定义好一组角色(ClusterRole),然后在多个命名空间中重复使用这些ClusterRole。

  • 下例中的RoleBinding绑定集群角色secret-reader,使用户dave只能读取development命名空间中的secret:
kind: RoleBinding
apiVersion: rbac.authorization.k8s.io/v1
metadata:
  name: read-secrets
  namespace: development

subjects:
- kind: User
  name: dave
  apiGroup: rbac.authorization.k8s.io
roleRef:
  kind: ClusterRole
  name: secret-reader
  apiGroup: rbac.authorization.k8s.io

集群角色绑定中的角色只能是集群角色,用于进行集群级别或者对所有命名空间都生效的授权。

  • 下例中的ClusterRoleBinding允许manager组的用户读取任意namespace中的secret
kind: ClusterRoleBinding
apiVersion: rbac.authorization.k8s.io/v1
metadata:
  name: read-secrets-global
subjects:
- kind: Group
  name: manager
  apiGroup: rbac.authorization.k8s.io
roleRef:
  kind: ClusterRole
  name: secret-reader
  apiGroup: rbac.authorization.k8s.io

2.对资源的引用方式

多数资源可以用其名称的字符串来表达,也就是Endpoint中的URL相对路径,例如pods。然后,某些Kubernetes API包含下级资源,例如Pod的日志(logs)。Pod日志的Endpoint是GET /api/v1/namespaces/{namespaces}/pods/{name}/logs。

Pod是一个命名空间内的资源,logs就是一个下级资源。要在一个RBAC角色中体现,则需要用斜线/来分割资源和下级资源。

  • 下例中授权让某个角色同时能够读取Pod和Pod logs,可以配置resources为一个数组:
kind: Role
apiVersion: rbac.authorization.k8s.io/v1
metadata:
  namespace: default
  name: pod-and-pod-logs-reader
rules:
- apiGroups: [""]
  resources: ["pods", "pods/log"]
  verbs: ["get", "list"]

  
资源还可以通过名字(ResourceName)进行引用。在指定ResourceName后,使用get、delete、update、patch动词的请求,就会被限制在这个资源实例范围内。

  • 下例的声明让一个主体只能对一个叫my-configmap的configmap进行get和update操作:
kind: Role
apiVersion: rbac.authorization.k8s.io/v1
metadata:
  namespace: default
  name: configmap-updater
rules:
- apiGroups: [""]
  resources: ["configmap"]
  resourceNames: ["my-configmap"]
  verbs: ["get", "update"]

3.常见的角色(Role)示例

  • 允许读取核心API组中的pod资源及允许读写"batch"和"extensions"组里的jobs资源
rules:
- apiGroups: [""]
  resources: ["pods"]
  verbs: ["get", "list", "watch"]
- apiGroups: ["batch", "extensions"]
  resources: ["jobs"]
  verbs: ["get", "list", "watch", "create", "update", "patch", "delete"]
  • 允许读取一个名为my-config的ConfigMap(必须绑定到一个RoleBinding来限制到一个namespace下的ConfigMap)
rules:
- apiGroups: [""]
  resources: ["configmaps"]
  resourceNames: ["my-config"]
  verbs: ["get"]
  • 读取核心组的node资源(Node属于集群级别的资源,必须放在ClusterRole中,并使用ClusterRoleBinding进行绑定)
rules:
- apiGroups: [""]
  resources: ["nodes"]
  verbs: ["get", "list", "watch"]

  

  • 允许对非资源端点/healthz及其所有子路径进行GET/POST操作(必须使用ClusterRole和ClusterRoleBinding)
rules:
- nonResourceURLs: ["/healthz", "/healthz/*"]
  verbs: ["get", "post"]

4.常用的角色绑定

  • 用户名Alice@example.com
subjects:
- kind: User
  name: "Alice@example.com"
  apiGroup: rbac.authorization.k8s.io
  • 组名frontend-admins
subjects:
- kind: Group
  name: "frontend-admins"
  apiGroup: rbac.authorization.k8s.io
  • kube-system命名空间中的默认ServiceAccount
subjects:
- kind: ServiceAccount
  name: default
  namespace: kube-system
  • qa命名空间中的所有Service Account
subjects:
- kind: Group
  name: system:serviceaccounts:qa
  apiGroup: rbac.authorization.k8s.io
  • 所有ServiceAccount
subjects:
- kind: Group
  name: system:serviceaccounts
  apiGroup: rbac.authorization.k8s.io
  • 全部用户(所有未认证+所有已认证)
subjects:
- kind: Group
  name: system:authentication
  apiGroup: rbac.authorization.k8s.io
- kind: Group
  name: system:unauthentication
  apiGroup: rbac.authorization.k8s.io

5.默认的角色和角色绑定

API Server会创建一套默认的ClusterRole和ClusterRoleBinding对象,其中很多是以system:为前缀的,以表明这些资源属于基础架构,对这些对象的改动可能造成集群故障。

常见的系统角色如下:

默认的ClusterRole 默认的ClusterRoleBinding 描述
system:basic-user system:authenticated 让用户能够读取自身的信息
system:discovery system:authenticated 对API发现Endpoint的只读访问,用于API级别的发现和协商
system:public-info-viewer system:authenticated 和 system:unauthenticated 组 允许对集群的非敏感信息进行只读访问

有些默认角色不是以system:为前缀的,这部分角色是针对用户的,其中包含超级用户角色cluster-admin,有的用于集群一级的角色cluster-status,还有针对namespace的角色admin、edit、view

常见的用户角色如下:

默认的ClusterRole 默认的ClusterRoleBinding 描述
cluster-admin system:masters组 让超级用户对任何资源执行任何操作,如果在ClusterRoleBinding中使用,则影响的是整个集群的所有namespace中的任何资源;如果使用的是RoleBinding,则能控制这一绑定的namespace中的资源,还包括namespace本身
admin None 允许admin,可以限制在一个namespace中使用RoleBinding。如果在RoleBinding中使用,则允许对namespace中的大多数资源进行读写访问,其中包含创建角色和角色绑定的能力。这一角色不允许操作namespace本身,也不能写入资源限额。
edit None 允许对命名空间内的大多数资源进行读写操作,不允许查看或修改角色,以及角色绑定。
view None 允许对多数对象进行只读操作,但是对角色,角色绑定及secret是不可访问的。

核心组件角色:

默认的ClusterRole 默认的ClusterRoleBinding 描述
system:kube-scheduler system:kube-scheduler用户 能够访问kube-scheduler组件所需的资源
system:kube-controller-manager system:kube-controller-manager用户 能够访问kube-controller-manager组件所需的资源
system:node system:nodes组 允许访问kubelet所需的资源,包括对secret的读取,以及对pod的写入。未来会把上面的两个权限限制在分配到本node的对象上。今后的鉴权过程,kubelet必须以system:node及一个system:node形式的用户名进行
system:node-proxier system:kube-proxy用户 允许访问kube-proxy所需的资源

其他组件角色:

默认ClusterRole 默认ClusterRoleBinding 描述
system:auth-delegator None 允许将身份认证和鉴权检查操作外包出去。 这种角色通常用在插件式 API 服务器上,以实现统一的身份认证和鉴权。
system:heapster Node 为 Heapster 组件(已弃用)定义的角色。
system:kube-aggregator Node 为 kube-aggregator 组件定义的角色。
system:kube-dns 在 kube-system 名字空间中的 kube-dns 服务账户 为 kube-dns 组件定义的角色。
system:kubelet-api-admin Node 允许 kubelet API 的完全访问权限。
system:node-bootstrapper Node 允许访问执行 kubelet TLS 启动引导所需要的资源。
system:node-problem-detector Node 为 node-problem-detector 组件定义的角色。
system:persistent-volume-provisioner Node 允许访问大部分 动态卷驱动 所需要的资源。
system:monitoring system:monitoring 组 允许对控制平面监控端点的读取访问(例如:kube-apiserver 存活和就绪端点(/healthz、/livez、/readyz), 各个健康检查端点(/healthz/、/livez/、/readyz/*)和 /metrics)。 请注意,各个运行状况检查端点和度量标准端点可能会公开敏感信息。

查询命令:

kubectl describe clusterrole admin
kubectl describe clusterrole cluster-admin
kubectl describe clusterrole edit
kubectl describe clusterrole view

参考文档:
https://kubernetes.io/zh/docs/reference/access-authn-authz/rbac/

posted on 2021-11-03 17:43  jiayou111  阅读(97)  评论(0编辑  收藏  举报