背景介绍

在Kubernetes1.5中,对于kubelet新增加了几个同认证/授权相关的几个启动参数,分别是:

认证相关参数:

anonymous-auth参数:是否启用匿名访问,可以选择true或者false,默认是true,表示启用匿名访问。

authentication-token-webhook参数:使用tokenreviewAPI来进行令牌认证。

authentication-token-webhook-cache-ttl参数:webhook令牌认证缓存响应时长。

client-ca-file参数:表示使用x509证书认证,如果设置此参数,那么就查找client-ca-file参数设置的认证文件,任何请求只有在认证文件中存在的对应的认证,那么才可以正常访问。

授权相关参数:

authorization-mode参数:kubelet的授权模式,可以选择AlwaysAllow或者Webhook,如果设置成Webhook,那么使用SubjectAccessReviewAPI进行授权。

authorization-webhook-cache-authorized-ttl参数:webhook授权时,已经被授权内容的缓存时长。

authorization-webhook-cache-unauthorized-ttl参数:webhook授权时,没有被授权内容的缓存时长。
认证

默认anonymous-auth参数设置成true,也就是可以进行匿名认证,这时对kubelet API的请求都以匿名方式进行,系统会使用默认匿名用户和默认用户组来进行访问,默认用户名“system:anonymous”,默认用户组名“system:unauthenticated”。

可以禁止匿名请求,这时就需要设置kubelet启动参数:“–anonymous-auth=false”,这时如果请求时未经过认证的,那么会返回“401 Unauthorized”。

可以使用x509证书认证(X.509格式的证书是最通用的一种签名证书格式)。这时就需要设置kubelet启动参数:“–client-ca-file”,提供认证文件,通过认证文件来进行认证。同时还需要设置api server组件启动参数:“–kubelet-client-certificate”和“–kubelet-client-key”。在认证文件中一个用户可以属于多个用户组,比如下面例子产生的认证:

openssl req -new -key jbeda.pem -outjbeda-csr.pem -subj “/CN=jbeda/O=app1/O=app2”

这个例子创建了csr认证文件,这个csr认证文件作用于用户jbeda,这个用户属于两个用户组,分别是app1和app2。

可以启用令牌认证,这时需要通过“–runtime-config=authentication.k8s.io/v1beta1=true“启用api server组件authentication.k8s.io/v1beta1相关的API,还需要启用kubelet组件的“–authentication-token-webhook”、“–kubeconfig”、“–require-kubeconfig”三个参数。

kubeconfig参数:设置kubelet配置文件路径,这个配置文件用来告诉kubelet组件api server组件的位置,默认路径是。

require-kubeconfig参数:这是一个布尔类型参数,可以设置成true或者false,如果设置成true,那么表示启用kubeconfig参数,从kubeconfig参数设置的配置文件中查找api server组件,如果设置成false,那么表示使用kubelet另外一个参数“api-servers”来查找api server组件位置。

在kubernetes源代码中,有一个错误的注释:

func NewKubeletServer() *KubeletServer {

versioned:= &v1alpha1.KubeletConfiguration{}

api.Scheme.Default(versioned)

config:= componentconfig.KubeletConfiguration{}

api.Scheme.Convert(versioned,&config, nil)

return&KubeletServer{

KubeConfig:           flag.NewStringFlag(“/var/lib/kubelet/kubeconfig”),

RequireKubeConfig:    false, // in 1.5, default to true

KubeletConfiguration:config,

}

}

这里面对RequireKubeConfig参数默认值的设置是false,但是在注释中写的确实true。

启用令牌认证后,kubelet会调用TokenReview API来进行令牌认证。

下面是一个kubeconfig文件格式样例:

clusters:

-name: name-of-remote-authn-service

cluster:

certificate-authority: /path/to/ca.pem         # 校验远程服务的认证文件

server: //authn.example.com/authenticate # 远程服务访问https路径

users:

-name: name-of-api-server

user:

client-certificate: /path/to/cert.pem    # webhook插件使用的认证文件

client-key: /path/to/key.pem         # 认证文件对应的密钥文件

current-context: webhook

contexts:

– context:

cluster: name-of-remote-authn-service

user: name-of-api-sever

name: webhook

认证请求格式样例如下:

{

“apiVersion”: “authentication.k8s.io/v1beta1”,

“kind”: “TokenReview”,

“spec”: {

“token”: “(BEARERTOKEN)”

}

}

成功的认证响应如下:

{

“apiVersion”: “authentication.k8s.io/v1beta1”,

“kind”: “TokenReview”,

“status”: {

“authenticated”: true,

“user”: {

“username”: “janedoe@example.com”,

“uid”: “42”,

“groups”: [

“developers”,

“qa”

],

“extra”: {

“extrafield1”: [

“extravalue1”,

“extravalue2”

]

}

}

}

}

失败的认证响应如下:

{

“apiVersion”: “authentication.k8s.io/v1beta1”,

“kind”: “TokenReview”,

“status”: {

“authenticated”: false

}

}
授权

任何请求被成功认证后才会被授权,包括匿名认证请求。默认的授权模式是AlwaysAllow,意味着允许任何请求。其实对于API的请求是需要进行更细粒度划分和授权的,有下面两点原因:

虽然允许匿名用户请求,但是应该限制匿名用户可以访问的API。

虽然允许认证用户请求,但是不同认证用户应该可以访问不同的API,而不能所有认证用户只能访问相同的API。

要想进行API权限控制,需要通过“–runtime-config= authorization.k8s.io /v1beta1=true“启用api server组件authorization.k8s.io/v1beta1相关的API,还需要将授权模式参数“–authorization-mode”设置成Webhook,然后启用kubelet组件的“–kubeconfig”和“–require-kubeconfig”两个参数,这两个参数的作用在上面认证章节已经详细介绍过了,这里不再介绍。

Kubelet接着就会调用api server组件的SubjectAccessReviewAPI来判断哪个请求需要进行授权控制。

请求动作类型是根据HTTP访问类型进行划分的,如下面表格所示:

HTTP verb	request verb
POST	create
GET, HEAD	get
PUT	update
PATCH	patch
DELETE	delete

资源访问请求是根据不同请求路径来进行划分的,如下面表格所示:

Kubelet API	资源名称	子资源名称
/stats/*	nodes	stats
/metrics/*	nodes	metrics
/logs/*	nodes	log
/spec/*	nodes	spec
all others	nodes	proxy

对于资源访问请求,访问时名字空间和API组这两个属性永远都是空值,资源名称的属性值就是kubelet所在节点对象名称。

要是想让kubelete API可以进行权限控制,还需要确保api server组件已经启用了“–kubelet-client-certificate”和“–kubelet-client-key”连个参数,

kubelet-client-certificate参数:客户端认证文件路径

kubelet-client-key参数:客户端密钥文件路径

还确保客户端被授权可以访问下面属性:

verb=*, resource=nodes,subresource=proxy

verb=*, resource=nodes, subresource=stats

verb=*, resource=nodes,subresource=log

verb=*, resource=nodes,subresource=spec

verb=*, resource=nodes,subresource=metrics
总结

Kubernetes1.5中增加了kubele API的认证和授权功能,从中可以发现社区对K8S在生产环节中安全性的设计日趋完善,也说明有越来越多的客户在生产环境中使用K8S了。经常访问K8S社区就会发现,在基础功能日趋完善的情况下,K8S社区现在对于跨云(Federation)和安全认证(Security/Auth)这两方面有了长足的进步,将来的K8S会适合更多的生产环境,会成为一款特别受欢迎的容器编排开源软件产品。

原文来自:

本文地址://gulass.cn/kubernetes-kubelet-api.html编辑:xiangping wu,审核员:逄增宝

Linux命令大全:

Linux系统大全:

红帽认证RHCE考试心得: