Concedere ruoli utilizzando le librerie client
Scopri come iniziare a utilizzare i metodi IAM dell'API Resource Manager nel tuo linguaggio di programmazione preferito.
Prima di iniziare
Crea un progetto Cloud de Confiance
Per questa guida rapida, è necessario un nuovo progetto Cloud de Confiance .
-
Installa Google Cloud CLI.
-
Configura gcloud CLI per utilizzare la tua identità federata.
Per ulteriori informazioni, vedi Accedi a gcloud CLI con la tua identità federata.
-
Per inizializzare gcloud CLI, esegui questo comando:
gcloud init -
Crea o seleziona un Cloud de Confiance progetto.
Ruoli richiesti per selezionare o creare un progetto
- Seleziona un progetto: la selezione di un progetto non richiede un ruolo IAM specifico. Puoi selezionare qualsiasi progetto per il quale ti è stato concesso un ruolo.
-
Crea un progetto: per creare un progetto, devi disporre del ruolo Autore progetto
(
roles/resourcemanager.projectCreator), che contiene l'autorizzazioneresourcemanager.projects.create. Scopri come concedere i ruoli.
-
Creare un progetto Cloud de Confiance :
gcloud projects create PROJECT_ID
Sostituisci
PROJECT_IDcon un nome per il progetto Cloud de Confiance che stai creando. -
Seleziona il progetto Cloud de Confiance che hai creato:
gcloud config set project PROJECT_ID
Sostituisci
PROJECT_IDcon il nome del progetto Cloud de Confiance .
Abilita l'API Resource Manager:
Ruoli richiesti per abilitare le API
Per abilitare le API, devi disporre del ruolo IAM Amministratore utilizzo dei servizi (
roles/serviceusage.serviceUsageAdmin), che include l'autorizzazioneserviceusage.services.enable. Scopri come concedere i ruoli.gcloud services enable cloudresourcemanager.googleapis.com
-
Crea credenziali di autenticazione locali per il tuo account utente:
gcloud auth application-default login
Se viene restituito un errore di autenticazione e utilizzi un provider di identità (IdP) esterno, verifica di aver acceduto a gcloud CLI con la tua identità federata.
-
Concedi ruoli al tuo account utente. Esegui il seguente comando una volta per ciascuno dei seguenti ruoli IAM:
roles/resourcemanager.projectIamAdmingcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE
Sostituisci quanto segue:
PROJECT_ID: il tuo ID progetto.USER_IDENTIFIER: l'identificatore del tuo account utente account. Per esempi, vedi Rappresenta gli utenti del pool di forza lavoro nelle policy IAM.ROLE: il ruolo IAM che concedi al tuo account utente.
Installa la libreria client
C#
Per saperne di più sulla configurazione dell'ambiente di sviluppo C#, consulta la Guida alla configurazione dell'ambiente di sviluppo C#.
install-package Google.Apis.Iam.v1 install-package Google.Apis.CloudResourceManager.v1
Go
go get golang.org/x/oauth2/google go get google.golang.org/api/cloudresourcemanager/v1
Java
Per ulteriori informazioni sulla configurazione dell'ambiente di sviluppo Java, consulta la Guida alla configurazione dell'ambiente di sviluppo Java.
Se utilizzi Maven, aggiungi questo al filepom.xml.
Python
Per ulteriori informazioni sulla configurazione dell'ambiente di sviluppo Python, consulta la Guida alla configurazione dell'ambiente di sviluppo Python.
pip install --upgrade google-api-python-client google-auth google-auth-httplib2
Leggere, modificare e scrivere una policy di autorizzazione
Lo snippet di codice in questa guida rapida esegue le seguenti operazioni:
- Inizializza il servizio Resource Manager, che gestisce i progetti Cloud de Confiance.
- Legge le norme di autorizzazione per il tuo progetto.
- Modifica la policy di autorizzazione concedendo il ruolo Writer log (
roles/logging.logWriter) al tuo Account Google. - Scrive la policy di autorizzazione aggiornata.
- Stampa tutte le entità con il ruolo Writer log
(
roles/logging.logWriter) a livello di progetto. - Revoca il ruolo di Writer log.
Sostituisci i seguenti valori prima di eseguire lo snippet di codice:
your-project: l'ID del progetto.your-member: l'indirizzo email del tuo account utente. Ad esempio,principal://iam.googleapis.com/locations/global/workforcePools/my-pool/subject/my-user@example.com.
C#
Per scoprire come installare e utilizzare la libreria client per Resource Manager, consulta Librerie client di Resource Manager. Per saperne di più, consulta la documentazione di riferimento dell'API Resource Manager C#.
Per eseguire l'autenticazione in Resource Manager, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
Go
Per scoprire come installare e utilizzare la libreria client per Resource Manager, consulta Librerie client di Resource Manager. Per saperne di più, consulta la documentazione di riferimento dell'API Resource Manager Go.
Per eseguire l'autenticazione in Resource Manager, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
Java
Per scoprire come installare e utilizzare la libreria client per Resource Manager, consulta Librerie client di Resource Manager. Per saperne di più, consulta la documentazione di riferimento dell'API Resource Manager Java.
Per eseguire l'autenticazione in Resource Manager, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
Python
Per scoprire come installare e utilizzare la libreria client per Resource Manager, consulta Librerie client di Resource Manager. Per saperne di più, consulta la documentazione di riferimento dell'API Resource Manager Python.
Per eseguire l'autenticazione in Resource Manager, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
Complimenti! Hai utilizzato i metodi IAM nell'API Resource Manager per modificare l'accesso a un progetto.
Com'è andata?
Esegui la pulizia
-
(Facoltativo) Revoca le credenziali di autenticazione che hai creato ed elimina il file delle credenziali locale.
gcloud auth application-default revoke
-
(Facoltativo) Revoca le credenziali da gcloud CLI.
gcloud auth revoke
Passaggi successivi
- Scopri di più su come funziona IAM.
- Scopri di più su come concedere, modificare e revocare l'accesso.
- Risolvi i problemi di accesso con lo strumento per la risoluzione dei problemi relativi ai criteri.