Zum Hauptinhalt springen

Kubeconfig erzeugen

Mit kubectl erzeugen Sie eine eigene Kubeconfig für einen Benutzer mit begrenzten Rechten: Sie lassen ein Client-Zertifikat über einen CertificateSigningRequest vom Cluster signieren, vergeben die Rechte per RoleBinding und bauen daraus die Konfigurationsdatei. So arbeiten Entwickler und Werkzeuge ohne die administrative Kubeconfig aus dem Control Panel.

Voraussetzungen​

  • Ein Cluster im Status Running und eine geprüfte Verbindung per kubectl mit der Kubeconfig aus dem Control Panel, siehe Mit dem Cluster verbinden
  • openssl auf Ihrem Rechner
  • Ein Namespace, auf den der neue Benutzer zugreifen soll – in den Beispielen entwicklung

In den Beispielen heißt der Benutzer entwickler. Ersetzen Sie Benutzer- und Namespace-Namen durch Ihre eigenen.

1. Schlüssel und Zertifikatsanforderung erstellen​

Erzeugen Sie einen privaten Schlüssel und daraus eine Zertifikatsanforderung (CSR):

openssl genrsa -out entwickler.key 4096
openssl req -new -key entwickler.key -out entwickler.csr \
-subj "/CN=entwickler/O=entwicklung-team"

Kubernetes liest den Benutzernamen aus dem Feld CN und die Gruppen aus den Feldern O. Auf diese Namen beziehen Sie sich später im RoleBinding.

Warnung

Tragen Sie als Gruppe niemals system:masters ein. Mitglieder dieser Gruppe haben uneingeschränkten Zugriff auf das Cluster, unabhängig von jedem RoleBinding.

Tipp

Der private Schlüssel muss das Gerät des Benutzers nicht verlassen. Lassen Sie Schlüssel und CSR vom Benutzer selbst erzeugen und sich nur die Datei entwickler.csr schicken.

2. CertificateSigningRequest im Cluster anlegen​

Übergeben Sie die CSR als CertificateSigningRequest-Objekt an das Cluster. expirationSeconds legt die gewünschte Laufzeit fest, im Beispiel 90 Tage:

cat <<EOF | kubectl apply -f -
apiVersion: certificates.k8s.io/v1
kind: CertificateSigningRequest
metadata:
name: entwickler
spec:
request: $(base64 < entwickler.csr | tr -d '\n')
signerName: kubernetes.io/kube-apiserver-client
expirationSeconds: 7776000
usages:
- client auth
EOF

Die Anforderung steht jetzt im Status Pending:

kubectl get csr entwickler

3. Anforderung genehmigen und Zertifikat auslesen​

kubectl certificate approve entwickler

Sobald die Spalte CONDITION den Wert Approved,Issued zeigt, lesen Sie das signierte Zertifikat aus:

kubectl get csr entwickler -o jsonpath='{.status.certificate}' \
| base64 -d > entwickler.crt

Prüfen Sie Benutzername und Ablaufdatum:

openssl x509 -in entwickler.crt -noout -subject -enddate

4. Rechte vergeben​

Ein neuer Benutzer hat zunächst keine Rechte. Weisen Sie ihm per RoleBinding eine Rolle zu – im Beispiel die vordefinierte ClusterRole edit, begrenzt auf den Namespace entwicklung:

kubectl create rolebinding entwickler-edit \
--clusterrole=edit \
--user=entwickler \
--namespace=entwicklung

Statt einzelner Benutzer können Sie mit --group=entwicklung-team auch die Gruppe aus dem Feld O berechtigen. Eigene Rollen und weitere Varianten beschreibt RoleBindings einrichten.

5. Kubeconfig zusammenstellen​

Lesen Sie Adresse und CA-Zertifikat des Clusters aus Ihrer aktuellen Kubeconfig aus:

SERVER=$(kubectl config view --minify -o jsonpath='{.clusters[0].cluster.server}')
kubectl config view --minify --raw \
-o jsonpath='{.clusters[0].cluster.certificate-authority-data}' \
| base64 -d > ca.crt

Bauen Sie daraus die neue Datei entwickler-kubeconfig.yaml. Mit --embed-certs landen alle Zertifikate und der Schlüssel direkt in der Datei:

KUBECONFIG_NEU=entwickler-kubeconfig.yaml

kubectl config set-cluster centron-cluster \
--server="$SERVER" \
--certificate-authority=ca.crt \
--embed-certs=true \
--kubeconfig="$KUBECONFIG_NEU"

kubectl config set-credentials entwickler \
--client-certificate=entwickler.crt \
--client-key=entwickler.key \
--embed-certs=true \
--kubeconfig="$KUBECONFIG_NEU"

kubectl config set-context entwickler@centron-cluster \
--cluster=centron-cluster \
--user=entwickler \
--namespace=entwicklung \
--kubeconfig="$KUBECONFIG_NEU"

kubectl config use-context entwickler@centron-cluster \
--kubeconfig="$KUBECONFIG_NEU"

chmod 600 "$KUBECONFIG_NEU"

6. Zugriff prüfen​

# Angemeldeten Benutzer anzeigen
kubectl --kubeconfig=entwickler-kubeconfig.yaml auth whoami

# Erlaubte Aktion im eigenen Namespace
kubectl --kubeconfig=entwickler-kubeconfig.yaml auth can-i create deployments

# Nicht erlaubte Aktion – erwartete Antwort: no
kubectl --kubeconfig=entwickler-kubeconfig.yaml auth can-i list nodes

7. Aufräumen und weitergeben​

Löschen Sie das CSR-Objekt und die lokalen Hilfsdateien. Der Schlüssel steckt jetzt in der Kubeconfig:

kubectl delete csr entwickler
rm entwickler.csr entwickler.crt ca.crt

Hat der Benutzer den Schlüssel selbst erzeugt, schicken Sie ihm nur entwickler.crt und ca.crt zusammen mit der Serveradresse – Schritt 5 führt er dann mit seinem eigenen Schlüssel aus.

Behandeln Sie die fertige Kubeconfig wie ein Passwort: nicht in Versionsverwaltungen einchecken und nicht über unverschlüsselte Kanäle weitergeben.

Zugriff entziehen​

Warnung

Kubernetes kann Client-Zertifikate nicht widerrufen. Ein ausgestelltes Zertifikat bleibt bis zu seinem Ablaufdatum gültig. Wählen Sie die Laufzeit in expirationSeconds deshalb nicht länger als nötig.

Um einem Benutzer den Zugriff vor Ablauf zu entziehen, löschen Sie seine RoleBindings. Er kann sich dann zwar noch anmelden, darf aber nichts mehr lesen oder ändern:

kubectl delete rolebinding entwickler-edit --namespace=entwicklung

Haben Sie Rechte über eine Gruppe vergeben, entfernen Sie das Binding der Gruppe – oder stellen Sie Benutzern, die weiter Zugriff haben sollen, neue Zertifikate mit einer anderen Gruppe aus.

Verwandte Themen​