Questa pagina mostra come configurare Google Gruppi per utilizzarlo con il controllo dell'accesso basato su ruoli (RBAC) di Kubernetes nei cluster Google Kubernetes Engine (GKE).
Panoramica
Google Gruppi per RBAC consente di assegnare autorizzazioni RBAC ai membri di Google Gruppi in Google Workspace. Gli amministratori di Google Workspace gestiscono utenti e gruppi completamente al di fuori di GKE o della console Google Cloud. Pertanto, gli amministratori del cluster non avranno bisogno di informazioni dettagliate sugli utenti.
L'utilizzo di Google Gruppi per RBAC ti consente inoltre l'integrazione con le pratiche di gestione degli account utente esistenti, ad esempio la revoca dell'accesso quando qualcuno lascia l'organizzazione.
Per utilizzare Google Gruppi per RBAC, completa le seguenti attività:
- Soddisfare i requisiti.
- Configura i tuoi gruppi Google.
- Abilita Google Gruppi per RBAC in un cluster.
- Definire e assegnare autorizzazioni RBAC ai gruppi Google.
Requisiti
Per utilizzare Google Gruppi per RBAC, devi avere accesso a Google Workspace o a qualsiasi versione di Cloud Identity.
Quando crei gruppi e aggiungi utenti come membri, assicurati di conoscere i limiti di Google Gruppi.
Limitazione
- GKE supporta gli utenti appartenenti a un massimo di 500 gruppi all'interno del gruppo di sicurezza, incluse le iscrizioni nidificate, con Google Gruppi per RBAC.
Configura i tuoi gruppi Google
I passaggi seguenti mostrano come configurare in Google Gruppi un gruppo che funziona con RBAC:
Crea un gruppo nel tuo dominio denominato
gke-security-groups
. Il nome digke-security-groups
è obbligatorio. Assicurati che il gruppo abbia l'autorizzazione Visualizza membri selezionata per Membri del gruppo. Per maggiori dettagli, vedi Impostare le autorizzazioni per la gestione di membri e contenuti.Crea gruppi, se non esistono già, che rappresentano insiemi di utenti che devono avere autorizzazioni diverse sui cluster, ad esempio sviluppatori e amministratori di cluster. Ogni gruppo deve disporre dell'autorizzazione Visualizza membri per Membri del gruppo.
Aggiungi i gruppi come gruppi nidificati al gruppo
gke-security-groups
. Non aggiungere singoli utenti come membri digke-security-groups
.
Per ulteriori informazioni sulla gestione di Google Gruppi, consulta il Centro assistenza Google Gruppi.
Per verificare se un utente specifico può eseguire un'azione su una risorsa cluster, GKE controlla se l'utente è membro di un gruppo con accesso e se tale gruppo è nidificato nel gruppo gke-security-groups
.
Le informazioni sull'iscrizione a Google Gruppi vengono memorizzate nella cache per un breve periodo di tempo. Potrebbero essere necessari alcuni minuti prima che le modifiche alle iscrizioni ai gruppi vengano propagate a tutti i cluster. Oltre alla latenza delle modifiche ai gruppi, la memorizzazione nella cache standard delle credenziali utente nel cluster richiede circa un'ora.
Abilita Google Gruppi per RBAC sui cluster
Puoi abilitare Google Gruppi per RBAC su cluster GKE Standard e Autopilot nuovi ed esistenti utilizzando Google Cloud CLI o la console Google Cloud.
Crea un nuovo cluster
gcloud
Standard
Per creare un nuovo cluster Standard e abilitare Google Gruppi per RBAC, esegui questo comando:
gcloud container clusters create CLUSTER_NAME \
--region=COMPUTE_REGION \
--security-group="gke-security-groups@DOMAIN"
Sostituisci quanto segue:
CLUSTER_NAME
: il nome del nuovo cluster.COMPUTE_REGION
: la regione di Compute Engine per il nuovo cluster. Per i cluster di zona, utilizza--zone=COMPUTE_ZONE
.DOMAIN
: il nome di dominio del gruppogke-security-groups
che hai creato.
Pilota automatico
Per creare un nuovo cluster Autopilot e abilitare Google Gruppi per RBAC, esegui questo comando:
gcloud container clusters create-auto CLUSTER_NAME \
--region=COMPUTE_REGION \
--security-group="gke-security-groups@DOMAIN"
Console
Per creare un nuovo cluster e abilitare la funzionalità Google Gruppi per RBAC, segui questi passaggi:
Vai alla pagina Google Kubernetes Engine nella console Google Cloud.
Fai clic su add_box Crea.
Fai clic su Configura per la modalità cluster che vuoi utilizzare.
Per i cluster Autopilot, espandi la sezione Opzioni avanzate per individuare le opzioni di Sicurezza.
Per i cluster standard, nella sezione Cluster, fai clic su Sicurezza.
Seleziona la casella di controllo Abilita Google Gruppi per RBAC.
Compila Gruppo di sicurezza con
gke-security-groups@DOMAIN
.Fai clic su Crea.
Aggiorna un cluster esistente
gcloud
Per aggiornare un cluster esistente e abilitare Google Gruppi per RBAC, esegui questo comando:
gcloud container clusters update CLUSTER_NAME \
--region=COMPUTE_REGION \
--security-group="gke-security-groups@DOMAIN"
Sostituisci quanto segue:
CLUSTER_NAME
: il nome del cluster.COMPUTE_REGION
: la regione di Compute Engine del cluster. Per i cluster di zona, utilizza--zone=COMPUTE_ZONE
.DOMAIN
: il nome di dominio del gruppogke-security-groups
che hai creato.
Console
Per aggiornare un cluster esistente e abilitare Google Gruppi per RBAC, segui questi passaggi:
Vai alla pagina Google Kubernetes Engine nella console Google Cloud.
Fai clic sul nome del cluster che vuoi aggiornare.
Nella scheda Dettagli, individua la sezione Sicurezza.
Nel campo Google Gruppi per RBAC, fai clic su edit Modifica Google Gruppi per RBAC.
Seleziona la casella di controllo Abilita Google Gruppi per RBAC.
Compila Gruppo di sicurezza con
gke-security-groups@DOMAIN
.Fai clic su Salva modifiche.
Definisci e assegna le autorizzazioni
Dopo aver creato e configurato Google Gruppi per RBAC, utilizza i ruoli e le associazioni di ruoli
per definire le autorizzazioni RBAC e assegnarle ai gruppi Google
che sono membri del gruppo gke-security-groups
. Per le istruzioni, consulta Definire e assegnare le autorizzazioni.
Verifica la configurazione di Google Gruppi per RBAC
Le sezioni seguenti mostrano come verificare che la configurazione di Google Gruppi per RBAC sia riuscita utilizzando gcloud CLI o la console Google Cloud.
Verifica mediante gcloud CLI
Esegui un comando kubectl can-i
per verificare se puoi eseguire un'azione specifica
su una specifica risorsa Kubernetes. Puoi utilizzare questo metodo per automatizzare i test dell'accesso RBAC nell'ambito del flusso di lavoro CI/CDCD.Ad esempio, i seguenti comandi verificano l'accesso get
alle risorse pods
nello spazio dei nomi dev
:
kubectl auth can-i get pods \
--namespace=dev \
--as=USER \
--as-group=GROUP
Sostituisci quanto segue:
USER
: il nome dell'utente che impersona, ad esempiogke-user@example.com
. L'utente specificato deve far parte del gruppo per il quale stai testando l'accesso.GROUP
: il nome del gruppo da impersonare, comegke-dev-users@example.com
.
Se USER
ha accesso, l'output è yes
. In caso contrario, l'output è no
.
Verifica utilizzando la console Google Cloud
Puoi anche verificare l'accesso a RBAC eseguendo un comando kubectl sul tuo cluster e controllando i log.
Prima di iniziare
Prima di iniziare, verifica quanto segue:
- Non hai interagito con il cluster che vuoi testare (ad esempio, non hai eseguito alcun comando
kubectl
) per almeno un'ora. L'autenticazione viene memorizzata nella cache per un'ora. La scadenza delle credenziali memorizzate nella cache ti consente di assicurarti che la richiesta venga registrata quando si verifica. - Sei membro di almeno uno dei gruppi che fanno parte del gruppo
gke-security-groups
, il che garantisce che alcune informazioni di Google Gruppi vengano registrate.
Abilita i log ed esegui un comando di prova
Abilita il logging degli accessi ai dati per il tuo progetto Google Cloud. Per abilitare il logging:
Vai alla pagina Audit log nella console Google Cloud.
Nella tabella, seleziona API Kubernetes Engine.
Nel menu Tipo di log, seleziona:
- Lettura amministratore
- Lettura dati
- Scrittura dati
Fai clic su Salva.
Per ulteriori informazioni sull'abilitazione dell'audit logging, consulta Configurazione dei log degli accessi ai dati con la console Cloud.
Esegui un comando utilizzando
kubectl
nel cluster, ad esempio:kubectl create ns helloworld
Inserisci una query personalizzata nella pagina Esplora log. Per eseguire la query:
Vai alla pagina Esplora log nella console Google Cloud.
Fai clic sulla freccia nella casella Anteprima query nella parte superiore della pagina.
Nella casella a discesa visualizzata, specifica la seguente query:
resource.type="k8s_cluster" resource.labels.location="CLUSTER_LOCATION" resource.labels.cluster_name="CLUSTER_NAME" protoPayload.resourceName="authorization.k8s.io/v1beta1/subjectaccessreviews" protoPayload.response.spec.user="EMAIL_ADDRESS"
Sostituisci quanto segue:
CLUSTER_LOCATION
: la regione o la zona del tuo cluster.CLUSTER_NAME
: il nome del tuo cluster.EMAIL_ADDRESS
: l'indirizzo email registrato del tuo Account Google.
Seleziona Esegui query. Dovrebbe essere visualizzato almeno un risultato. Se non viene visualizzato alcun risultato, prova ad aumentare l'intervallo di tempo.
Seleziona il cluster da esaminare.
Fai clic su Espandi campi nidificati.
Il campo
protoPayload.request.spec.group
contiene i gruppi in cui:- I gruppi sono membri di
gke-security-group
. - Sei un membro del gruppo.
Questo elenco deve corrispondere all'insieme dei gruppi di cui sei membro. Se non sono presenti gruppi, potrebbe esserci un problema di configurazione dei gruppi.
- I gruppi sono membri di
Facoltativamente, ripristina le impostazioni precedenti del logging degli accessi ai dati per evitare ulteriori addebiti.