Wenn Sie die Anmeldedaten aktualisieren möchten, die Pods zur Authentifizierung verwenden, können Sie das Schlüsselpaar rotieren, mit dem Google Distributed Cloud die KSA-Tokens (Kubernetes-Dienstkonto) signiert, die es an Pods in einem Nutzercluster ausgibt. Bei der Rotation werden die privaten und öffentlichen Schlüssel ersetzt, mit dem neuen privaten Schlüssel signierte Tokens neu ausgestellt undGoogle Cloud der neue öffentliche Schlüssel für die Workload Identity-Authentifizierung bereitgestellt. Die Schlüsselrotation wird für erweiterte Cluster nicht unterstützt.
Informationen zu KSA-Signaturschlüsseln
Ein KSA bietet eine Identität für Prozesse, die in einem Pod ausgeführt werden. KSAs unterscheiden sich von Google Cloud -Dienstkonten, mit denen Anwendungen autorisierte Aufrufe zu Google Cloud -APIs ausführen.
Google Distributed Cloud verwendet einen privaten Schlüssel, um die KSA-Tokens zu signieren, die es an Pods ausgibt, und den entsprechenden öffentlichen Schlüssel, um die Tokens zu validieren, wenn Pods Anfragen an den Kubernetes API-Server senden. Wenn ein Pod Workload Identity verwendet, um APIs von Google Cloud aufzurufen, verwendet Google Cloud denselben öffentlichen Schlüssel zur Authentifizierung der Identität des Pods. Beim Erstellen des Nutzerclusters generiert Google Distributed Cloud das Schlüsselpaar, registriert den Cluster bei einer Flotte und stellt den öffentlichen Schlüssel für Google Cloudbereit.
Gebundene Tokens und Legacy-Tokens
Ein Pod kann entweder ein Legacy-Token oder ein gebundenes Token zur Authentifizierung und Autorisierung verwenden, wenn er den Kubernetes API-Server aufruft. Gebundene Tokens haben eine begrenzte Lebensdauer und werden mithilfe von projizierten Volumes an Pods verteilt. Legacy-Tokens laufen nie ab und werden in Kubernetes-Secrets aufbewahrt: Wir empfehlen gebundene Tokens, da sie sicherer sind.
Sowohl gebundene Tokens als auch Legacy-Tokens werden während einer Schlüsselrotation aktualisiert.
Beschränkungen
- Wenn Sie den Cluster mit
enableAdvancedClusterauftrueerstellt haben (was für die Einrichtung von Topologiedomänen erforderlich ist), wird die Schlüsselrotation nicht unterstützt.
Schlüsselrotation starten
Beachten Sie vor dem Starten einer Schlüsselrotation die folgenden Punkte:
Während einer Schlüsselrotation können Sie keine weitere Schlüsselrotation, Zertifizierungsstellenrotation oder Clusteraktualisierung starten.
Die Schlüsselrotation kann nicht pausiert oder rückgängig gemacht werden. Alle alten Schlüssel werden gelöscht.
Bei einer Schlüsselrotation werden vorhandene Clusterknoten gelöscht und neue Knoten erstellt.
So starten Sie eine Schlüsselrotation:
gkectl update credentials ksa-signing-key rotate \
--config USER_CLUSTER_CONFIG \
--kubeconfig ADMIN_KUBECONFIG_FILE \
[--skip-prompt]
Ersetzen Sie Folgendes:
USER_CLUSTER_CONFIG: der Pfad Ihrer Nutzerclusterkonfigurationsdatei.
ADMIN_KUBECONFIG_FILE: der Pfad der kubeconfig-Datei des Administratorclusters
Geben Sie --skip-prompt ein, wenn Sie nicht dazu aufgefordert werden wollen.
Status einer Schlüsselrotation ansehen
So rufen Sie den Status einer Schlüsselrotation auf:
gkectl update credentials ksa-signing-key status \
--config USER_CLUSTER_CONFIG \
--kubeconfig ADMIN_KUBECONFIG_FILE
Wenn die Schlüsselrotation bereits abgeschlossen ist, wird eine Meldung wie diese angezeigt:
State of KSASigningKeyRotation with KSASigningKeyVersion 2 is -
status: True,
reason: KSASigningKeyRotationCompleted,
message:{"tokenVersion":2,"privateKeyVersion":2,"publicKeyVersions":[2]}
Wenn die Schlüsselrotation des KSA-Signaturschlüssels noch läuft, wird eine Meldung wie diese angezeigt:
State of KSASigningKeyRotation with KSASigningKeyVersion 2 is -
status: False,
reason: KSASigningKeyRotationProcessedReason,
message:{"tokenVersion":2,"privateKeyVersion":2,"publicKeyVersions":[1,2]}