在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会适合更多的生产环境，会成为一款特别受欢迎的容器编排开源软件产品。
原文来自：
本文地址：//q13zd.cn/kubernetes-kubelet-api.html编辑：xiangping wu，审核员：逄增宝
Linux命令大全：
Linux系统大全：
