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