在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系统大全: