@@ -349,14 +349,24 @@ CSRs requesting serving certificates for any IP or domain name.
349
349
350
350
# # Generating kubeconfig files for additional users {#kubeconfig-additional-users}
351
351
352
- During cluster creation, kubeadm signs the certificate in the `admin.conf` to have
353
- `Subject : O = system:masters, CN = kubernetes-admin`.
352
+ During cluster creation, ` kubeadm init` signs the certificate in the `super- admin.conf`
353
+ to have `Subject : O = system:masters, CN = kubernetes-super -admin`.
354
354
[`system:masters`](/docs/reference/access-authn-authz/rbac/#user-facing-roles)
355
355
is a break-glass, super user group that bypasses the authorization layer (for example,
356
- [RBAC](/docs/reference/access-authn-authz/rbac/)).
357
- Sharing the `admin.conf` with additional users is **not recommended**!
356
+ [RBAC](/docs/reference/access-authn-authz/rbac/)). The file `admin.conf` is also created
357
+ by kubeadm on control plane nodes and it contains a certificate with
358
+ `Subject : O = kubeadm:cluster-admins, CN = kubernetes-admin`. `kubeadm:cluster-admins`
359
+ is a group logically belonging to kubeadm. If your cluster uses RBAC
360
+ (the kubeadm default), the `kubeadm:cluster-admins` group is bound to the
361
+ [`cluster-admin`](/docs/reference/access-authn-authz/rbac/#user-facing-roles) ClusterRole.
358
362
359
- Instead, you can use the [`kubeadm kubeconfig user`](/docs/reference/setup-tools/kubeadm/kubeadm-kubeconfig)
363
+ {{< warning >}}
364
+ Avoid sharing the `super-admin.conf` or `admin.conf` files. Instead, create least
365
+ privileged access even for people who work as administrators and use that least
366
+ privilege alternative for anything other than break-glass (emergency) access.
367
+ {{< /warning >}}
368
+
369
+ You can use the [`kubeadm kubeconfig user`](/docs/reference/setup-tools/kubeadm/kubeadm-kubeconfig)
360
370
command to generate kubeconfig files for additional users.
361
371
The command accepts a mixture of command line flags and
362
372
[kubeadm configuration](/docs/reference/config-api/kubeadm-config.v1beta4/) options.
0 commit comments