Ruotare le chiavi di firma KSA

Per aggiornare le credenziali utilizzate dai pod per l'autenticazione, puoi ruotare la coppia di chiavi utilizzata da Google Distributed Cloud per firmare i token dell'account di servizio Kubernetes (KSA) che emette per i pod in un cluster utente. La rotazione sostituisce le chiavi private e pubbliche, riemette i token firmati dalla nuova chiave privata e fornisce aGoogle Cloud la nuova chiave pubblica per l'autenticazione di Workload Identity. La rotazione delle chiavi non è supportata sui cluster avanzati.

Informazioni sulle chiavi di firma KSA

Un KSA fornisce un'identità per i processi eseguiti in un pod. I KSA sono diversi dai service accountGoogle Cloud , che le applicazioni utilizzano per effettuare chiamate autorizzate alle API Google Cloud .

Google Distributed Cloud utilizza una chiave privata per firmare i token KSA che emette per i pod e la chiave pubblica corrispondente per convalidare i token quando i pod inviano richieste al server API Kubernetes. Quando un pod utilizza Workload Identity per chiamare le API Google Cloud , Google Cloud utilizza la stessa chiave pubblica per autenticare l'identità del pod. Durante la creazione del cluster utente, Google Distributed Cloud genera la coppia di chiavi, registra il cluster in un parco risorse e fornisce la chiave pubblica a Google Cloud.

Token associati e token legacy

Un pod può utilizzare un token legacy o un token associato per l'autenticazione e l'autorizzazione quando chiama il server API Kubernetes. I token associati hanno una durata limitata e vengono distribuiti ai pod utilizzando volumi proiettati. I token legacy non scadono mai e sono conservati nei Secret di Kubernetes. Ti consigliamo i token associati perché sono più sicuri.

Sia i token associati sia i token legacy vengono aggiornati durante la rotazione della chiave.

Limitazioni

Avvia una rotazione della chiave

Prima di avviare una rotazione della chiave, tieni presente quanto segue:

  • Durante una rotazione della chiave, non puoi avviare un'altra rotazione della chiave, una rotazione dell'autorità di certificazione o un aggiornamento del cluster.

  • La rotazione delle chiavi non può essere messa in pausa o annullata. Tutte le chiavi precedenti vengono eliminate.

  • La rotazione della chiave elimina i nodi del cluster esistenti e ne crea di nuovi.

Per avviare una rotazione della chiave:

gkectl update credentials ksa-signing-key rotate \
    --config USER_CLUSTER_CONFIG \
    --kubeconfig ADMIN_KUBECONFIG_FILE \
    [--skip-prompt]

Sostituisci quanto segue:

  • USER_CLUSTER_CONFIG: il percorso del file di configurazione del cluster utente

  • ADMIN_KUBECONFIG_FILE: il percorso del file kubeconfig del cluster di amministrazione

Includi --skip-prompt se non vuoi che ti venga chiesto.

Visualizza lo stato di una rotazione della chiave

Per visualizzare lo stato di una rotazione della chiave:

gkectl update credentials ksa-signing-key status \
    --config USER_CLUSTER_CONFIG \
    --kubeconfig ADMIN_KUBECONFIG_FILE

Se la rotazione della chiave è già stata completata, vedrai un messaggio simile al seguente:

State of KSASigningKeyRotation with KSASigningKeyVersion 2 is -
status: True,
reason: KSASigningKeyRotationCompleted,
message:{"tokenVersion":2,"privateKeyVersion":2,"publicKeyVersions":[2]}

Se la rotazione della chiave di firma KSA è ancora in corso, vedrai un messaggio simile al seguente:

State of KSASigningKeyRotation with KSASigningKeyVersion 2 is -
status: False,
reason: KSASigningKeyRotationProcessedReason,
message:{"tokenVersion":2,"privateKeyVersion":2,"publicKeyVersions":[1,2]}