TLS Bootstrap

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

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

产生的 token 类似于这样：

02b50b05283e98dd0fd71db496ef01e8

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

02b50b05283e98dd0fd71db496ef01e8,kubelet-bootstrap,10001,system:kubelet-bootstrap

注意：system:kubelet-bootstrap 的配置，当只有一个组时，不需要加引号

在 kube-apiserver 命令中添加 –token-auth-file=FILENAME 标志（可能在 systemd unit 文件中）来启用 token 文件

在 kube-apiserver 命令中添加 –client-ca-file=FILENAME 标志 启用 客户端证书认证 ，指定包含签名证书的证书颁发机构包

     例如 --client-ca-file=/var/lib/kubernetes/ca.pem

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

kube-apiserver 通过指定的 –client-ca-file=FILENAME 标志来认证和采信该 CA

CA 的管理超出了本文档的范围，但建议您为 Kubernetes 生成专用的 CA

假定证书和密钥都是 PEM 编码的。Kube-controller-manager 标志为：

--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 AP_I 来确定给定用户是否已被授权允许请求 CSR，然后根据授权结果进行批准

     为了防止与其他批准者冲突，内置审批者没有明确地拒绝 CSR，只是忽略未经授权的请求

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

• nodeclient ：用户的客户端认证请求 O=system:nodes， CN=system:node:(node name)
• selfnodeclient：更新具有相同 O 和 CN 的客户端证书的节点

• selfnodeserver：更新服务证书的节点（ALPHA，需要 feature gate）

  当前，确定 CSR 是否为 selfnodeserver 请求的检查与 kubelet 的凭据轮换实现（Alpha 功能）相关联

         因此 selfnodeserver 的定义将来可能会改变，并且需要 Controller Manager 上的RotateKubeletServerCertificate feature gate
  

  --feature-gates=RotateKubeletServerCertificate=true
  

  以下 RBAC ClusterRoles 代表 nodeClient、selfnodeclient 和 selfnodeserver 功能

  # A ClusterRole which instructs the CSR approver to approve a user requesting
  # node client credentials.
  kind: ClusterRole
  apiVersion: rbac.authorization.k8s.io/v1beta1
  metadata:
    name: approve-node-client-csr
  rules:
  - apiGroups: ["certificates.k8s.io"]
    resources: ["certificatesigningrequests/nodeclient"]
    verbs: ["create"]
  ---
  # A ClusterRole which instructs the CSR approver to approve a node renewing its
  # own client credentials.
  kind: ClusterRole
  apiVersion: rbac.authorization.k8s.io/v1beta1
  metadata:
    name: approve-node-client-renewal-csr
  rules:
  - apiGroups: ["certificates.k8s.io"]
    resources: ["certificatesigningrequests/selfnodeclient"]
    verbs: ["create"]
  ---
  # A ClusterRole which instructs the CSR approver to approve a node requesting a
  # serving cert matching its client cert.
  kind: ClusterRole
  apiVersion: rbac.authorization.k8s.io/v1beta1
  metadata:
    name: approve-node-server-renewal-csr
  rules:
  - apiGroups: ["certificates.k8s.io"]
    resources: ["certificatesigningrequests/selfnodeserver"]
    verbs: ["create"]
  

  这些权力可以授予给凭证，如 bootstrap token

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

         例如，要复制由已被移除的自动批准标志提供的行为，由单个组批准所有的 CSR
  

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

  # Approve all CSRs for the group "kubelet-bootstrap-token"
  kind: ClusterRoleBinding
  apiVersion: rbac.authorization.k8s.io/v1beta1
  metadata:
    name: auto-approve-csrs-for-group
  subjects:
  - kind: Group
    name: kubelet-bootstrap-token
    apiGroup: rbac.authorization.k8s.io
  roleRef:
    kind: ClusterRole
    name: approve-node-client-csr
    apiGroup: rbac.authorization.k8s.io
  

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

  kind: ClusterRoleBinding
  apiVersion: rbac.authorization.k8s.io/v1beta1
  metadata:
    name: node1-client-cert-renewal
  subjects:
  - kind: User
    name: system:node:node-1 # Let "node-1" renew its client certificate.
    apiGroup: rbac.authorization.k8s.io
  roleRef:
    kind: ClusterRole
    name: approve-node-client-renewal-csr
    apiGroup: rbac.authorization.k8s.io
  

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

签名控制器不会立即签署所有证书请求。相反，它会一直等待直到适当特权的用户被标记为 “已批准” 状态

     这最终将是由外部审批控制器来处理的自动化过程，但是对于 alpha 版本的 API 来说，可以由集群管理员通过 kubectl 命令手动完成

管理员可以使用：

• kubectl get csr 命令列出所有的 CSR
• kubectl describe csr <name> 命令描述某个 CSR的详细信息
• kubectl certificate approve <name> 和 kubectl certificate deny <name>