• TLS Bootstrap
  • kube-apiserver 配置
    • Token 认证文件
    • 客户端证书 CA 包
    • kube-controller-manager 配置
    • 签名文件
    • 审批控制器
  • kubelet 配置
  • kubectl 审批

    TLS Bootstrap

    本文档介绍如何为 kubelet 设置 TLS 客户端证书引导(bootstrap)。

    Kubernetes 1.4 引入了一个用于从集群级证书颁发机构(CA)请求证书的 API。此 API 的原始目的是为 kubelet 提供 TLS 客户端证书。可以在 这里 找到该提议,在 feature #43 追踪该功能的进度。

    kube-apiserver 配置

    您必须提供一个 token 文件,该文件中指定了至少一个分配给 kubelet 特定 bootstrap 组的 “bootstrap token”。

    该组将作为 controller manager 配置中的默认批准控制器而用于审批。随着此功能的成熟,您应该确保 token 被绑定到基于角色的访问控制(RBAC)策略上,该策略严格限制了与证书配置相关的客户端请求(使用 bootstrap token)。使用 RBAC,将 token 范围划分为组可以带来很大的灵活性(例如,当您配置完成节点后,您可以禁用特定引导组的访问)。

    Token 认证文件

    Token 可以是任意的,但应该可以表示为从安全随机数生成器(例如大多数现代操作系统中的 /dev/urandom)导出的至少128位熵。生成 token 有很多中方式。例如:

    head -c 16 /dev/urandom | od -An -t x | tr -d ' '

    产生的 token 类似于这样: 02b50b05283e98dd0fd71db496ef01e8

    Token 文件应该类似于以下示例,其中前三个值可以是任何值,引用的组名称应如下所示:

    1. 02b50b05283e98dd0fd71db496ef01e8,kubelet-bootstrap,10001,"system:kubelet-bootstrap"

    在 kube-apiserver 命令中添加 --token-auth-file=FILENAME 标志(可能在您的 systemd unit 文件中)来启用 token 文件。

    查看 该文档 获取更多详细信息。

    客户端证书 CA 包

    在 kube-apiserver 命令中添加 --client-ca-file=FILENAME 标志启用客户端证书认证,指定包含签名证书的证书颁发机构包(例如 --client-ca-file=/var/lib/kubernetes/ca.pem)。

    kube-controller-manager 配置

    请求证书的 API 向 Kubernetes controller manager 中添加证书颁发控制循环。使用磁盘上的 cfssl 本地签名文件的形式。目前,所有发型的证书均为一年有效期和并具有一系列关键用途。

    签名文件

    您必须提供证书颁发机构,这样才能提供颁发证书所需的密码资料。

    kube-apiserver 通过指定的 --client-ca-file=FILENAME 标志来认证和采信该 CA。CA 的管理超出了本文档的范围,但建议您为 Kubernetes 生成专用的 CA。

    假定证书和密钥都是 PEM 编码的。

    Kube-controller-manager 标志为:

    1. --cluster-signing-cert-file="/etc/path/to/kubernetes/ca/ca.crt" --cluster-signing-key-file="/etc/path/to/kubernetes/ca/ca.key"

    审批控制器

    在 kubernetes 1.7 版本中,实验性的 “组自动批准” 控制器被弃用,新的 csrapproving 控制器将作为 kube-controller-manager 的一部分,被默认启用。

    控制器使用 SubjectAccessReview API 来确定给定用户是否已被授权允许请求 CSR,然后根据授权结果进行批准。为了防止与其他批准者冲突,内置审批者没有明确地拒绝 CSR,只是忽略未经授权的请求。

    控制器将 CSR 分为三个子资源:

    1. nodeclient :用户的客户端认证请求 O=system:nodesCN=system:node:(node name)
    2. selfnodeclient:更新具有相同 OCN 的客户端证书的节点。
    3. selfnodeserver:更新服务证书的节点(ALPHA,需要 feature gate)。

    当前,确定 CSR 是否为 selfnodeserver 请求的检查与 kubelet 的凭据轮换实现(Alpha 功能)相关联。因此,selfnodeserver 的定义将来可能会改变,并且需要 Controller Manager 上的RotateKubeletServerCertificate feature gate。该功能的进展可以在 kubernetes/feature/#267 上追踪。

    1. --feature-gates=RotateKubeletServerCertificate=true

    以下 RBAC ClusterRoles 代表 nodeClientselfnodeclientselfnodeserver 功能。在以后的版本中可能会自动创建类似的角色。

    1. # A ClusterRole which instructs the CSR approver to approve a user requesting
    2. # node client credentials.
    3. kind: ClusterRole
    4. apiVersion: rbac.authorization.k8s.io/v1beta1
    5. metadata:
    6. name: approve-node-client-csr
    7. rules:
    8. - apiGroups: ["certificates.k8s.io"]
    9. resources: ["certificatesigningrequests/nodeclient"]
    10. verbs: ["create"]
    11. ---
    12. # A ClusterRole which instructs the CSR approver to approve a node renewing its
    13. # own client credentials.
    14. kind: ClusterRole
    15. apiVersion: rbac.authorization.k8s.io/v1beta1
    16. metadata:
    17. name: approve-node-client-renewal-csr
    18. rules:
    19. - apiGroups: ["certificates.k8s.io"]
    20. resources: ["certificatesigningrequests/selfnodeclient"]
    21. verbs: ["create"]
    22. ---
    23. # A ClusterRole which instructs the CSR approver to approve a node requesting a
    24. # serving cert matching its client cert.
    25. kind: ClusterRole
    26. apiVersion: rbac.authorization.k8s.io/v1beta1
    27. metadata:
    28. name: approve-node-server-renewal-csr
    29. rules:
    30. - apiGroups: ["certificates.k8s.io"]
    31. resources: ["certificatesigningrequests/selfnodeserver"]
    32. verbs: ["create"]

    这些权力可以授予给凭证,如 bootstrap token。例如,要复制由已被移除的自动批准标志提供的行为,由单个组批准所有的 CSR:

    1. # REMOVED: This flag no longer works as of 1.7.
    2. --insecure-experimental-approve-all-kubelet-csrs-for-group="kubelet-bootstrap-token"

    管理员将创建一个 ClusterRoleBinding 来定位该组。

    1. # Approve all CSRs for the group "kubelet-bootstrap-token"
    2. kind: ClusterRoleBinding
    3. apiVersion: rbac.authorization.k8s.io/v1beta1
    4. metadata:
    5. name: auto-approve-csrs-for-group
    6. subjects:
    7. - kind: Group
    8. name: kubelet-bootstrap-token
    9. apiGroup: rbac.authorization.k8s.io
    10. roleRef:
    11. kind: ClusterRole
    12. name: approve-node-client-csr
    13. apiGroup: rbac.authorization.k8s.io

    要让节点更新自己的凭据,管理员可以构造一个 ClusterRoleBinding 来定位该节点的凭据。

    1. kind: ClusterRoleBinding
    2. apiVersion: rbac.authorization.k8s.io/v1beta1
    3. metadata:
    4. name: node1-client-cert-renewal
    5. subjects:
    6. - kind: User
    7. name: system:node:node-1 # Let "node-1" renew its client certificate.
    8. apiGroup: rbac.authorization.k8s.io
    9. roleRef:
    10. kind: ClusterRole
    11. name: approve-node-client-renewal-csr
    12. apiGroup: rbac.authorization.k8s.io

    删除该绑定将会阻止节点更新客户端凭据,一旦其证书到期,实际上就会将其从集群中删除。

    kubelet 配置

    要向 kube-apiserver 请求客户端证书,kubelet 首先需要一个包含 bootstrap 身份验证 token 的 kubeconfig 文件路径。您可以使用 kubectl config set-clusterset-credentialsset-context 来构建此 kubeconfig 文件。为 kubectl config set-credentials 提供 kubelet-bootstrap 的名称,并包含 --token = <token-value>,如下所示:

    1. kubectl config set-credentials kubelet-bootstrap --token=${BOOTSTRAP_TOKEN} --kubeconfig=bootstrap.kubeconfig

    启动 kubelet 时,如果 --kubeconfig 指定的文件不存在,则使用 bootstrap kubeconfig 向 API server 请求客户端证书。在批准 kubelet 的证书请求和回执时,将包含了生成的密钥和证书的 kubeconfig 文件写入由 -kubeconfig 指定的路径。证书和密钥文件将被放置在由 --cert-dir 指定的目录中。

    启动 kubelet 时启用 bootstrap 用到的标志:

    1. --experimental-bootstrap-kubeconfig="/path/to/bootstrap/kubeconfig"

    此外,在1.7中,kubelet 实现了 Alpha 功能,使其客户端和/或服务器都能轮转提供证书。

    可以分别通过 kubelet 中的 RotateKubeletClientCertificateRotateKubeletServerCertificate 功能标志启用此功能,但在未来版本中可能会以向后兼容的方式发生变化。

    1. --feature-gates=RotateKubeletClientCertificate=true,RotateKubeletServerCertificate=true

    RotateKubeletClientCertificate 可以让 kubelet 在其现有凭据到期时通过创建新的 CSR 来轮换其客户端证书。 RotateKubeletServerCertificate 可以让 kubelet 在其引导客户端凭据后还可以请求服务证书,并轮换该证书。服务证书目前不要求 DNS 或 IP SANs。

    kubectl 审批

    签名控制器不会立即签署所有证书请求。相反,它会一直等待直到适当特权的用户被标记为 “已批准” 状态。这最终将是由外部审批控制器来处理的自动化过程,但是对于 alpha 版本的 API 来说,可以由集群管理员通过 kubectl 命令手动完成。

    管理员可以使用 kubectl get csr 命令列出所有的 CSR,使用 kubectl describe csr <name> 命令描述某个 CSR的详细信息。在 1.6 版本以前,没有直接的批准/拒绝命令 ,因此审批者需要直接更新 Status 信息(查看如何实现)。此后的 Kubernetes 版本中提供了 kubectl certificate approve <name>kubectl certificate deny <name> 命令。