Kublet 的认证授权

查看本文大纲

Kubelet 的 HTTPS 端点对外暴露了用于访问不同敏感程度数据的 API,并允许你在节点或者容器内执行不同权限级别的操作。

本文档向你描述如何通过认证授权来访问 kubelet 的 HTTPS 端点。

Kubelet 认证

默认情况下,所有未被配置的其他身份验证方法拒绝的,对 kubelet 的 HTTPS 端点的请求将被视为匿名请求,并被授予 system:anonymous 用户名和 system:unauthenticated 组。

如果要禁用匿名访问并发送 401 Unauthorized 的未经身份验证的请求的响应:

  • 启动 kubelet 时指定 --anonymous-auth=false 标志

如果要对 kubelet 的 HTTPS 端点启用 X509 客户端证书身份验证:

  • 启动 kubelet 时指定 --client-ca-file 标志,提供 CA bundle 以验证客户端证书
  • 启动 apiserver 时指定 --kubelet-client-certificate--kubelet-client-key 标志
  • 参阅 apiserver 认证文档 获取更多详细信息。

启用 API bearer token(包括 service account token)用于向 kubelet 的 HTTPS 端点进行身份验证:

  • 确保在 API server 中开启了 authentication.k8s.io/v1beta1 API 组。
  • 启动 kubelet 时指定 --authentication-token-webhook--kubeconfig--require-kubeconfig 标志
  • Kubelet 在配置的 API server 上调用 TokenReview API 以确定来自 bearer token 的用户信息

Kubelet 授权

接着对任何成功验证的请求(包括匿名请求)授权。默认授权模式为 AlwaysAllow,允许所有请求。

细分访问 kubelet API 有很多原因:

  • 启用匿名认证,但匿名用户调用 kubelet API 的能力应受到限制
  • 启动 bearer token 认证,但是 API 用户(如 service account)调用 kubelet API 的能力应受到限制
  • 客户端证书身份验证已启用,但只有那些配置了 CA 签名的客户端证书的用户才可以使用 kubelet API

如果要细分访问 kubelet API,将授权委托给 API server:

  • 确保 API server 中启用了 authorization.k8s.io/v1beta1 API 组
  • 启动 kubelet 时指定 --authorization-mode=Webhook--kubeconfig--require-kubeconfig 标志
  • kubelet 在配置的 API server 上调用 SubjectAccessReview API,以确定每个请求是否被授权

kubelet 使用与 apiserver 相同的 请求属性 方法来授权 API 请求。

Verb(动词)是根据传入的请求的 HTTP 动词确定的:

HTTP 动词 request 动词
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

Namespace 和 API 组属性总是空字符串,资源的名字总是 kubelet 的 Node API 对象的名字。

当以该模式运行时,请确保用户为 apiserver 指定了 --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