Utilizzare le condizioni IAM

Console

Questo esempio mostra come modificare l'associazione IAM esistente per il progetto per assegnare a un account di servizio un ruolo client Cloud SQL per un'istanza specifica.

Questo esempio utilizza le seguenti variabili:

• PROJECT_ID: il tuo progetto Google Cloud.
• INSTANCE_ID: il nome dell'istanza a cui vuoi concedere accesso.

1. Nella console Google Cloud, vai alla pagina IAM.

   Vai a IAM

2. Fai clic su Aggiungi.
3. Nella casella di immissione Nuovi membri, inserisci l'indirizzo email dell'account di servizio.
4. Fai clic sull'elenco a discesa Ruolo e seleziona il ruolo Client Cloud SQL.
5. Fai clic su Aggiungi condizione.
6. Inserisci un titolo e una descrizione.
7. Seleziona la scheda Editor delle condizioni.
8. Nella sezione Generatore di condizioni:
   • In Tipo di condizione - Risorsa - Nome, inserisci projects/PROJECT_ID/instances/INSTANCE_ID
   • Assicurati che l'operatore condizionale AND sia selezionato.
   • In Tipo di condizione - Risorsa - Servizio, seleziona sqladmin.googleapis.com.
9. Fai clic su Salva per salvare la condizione.
10. Fai clic su Salva per salvare il criterio.

gcloud

Questo esempio mostra come modificare l'associazione del criterio IAM esistente per il progetto in modo da assegnare a un account di servizio specifico il ruolo Client Cloud SQL, ma solo per un'istanza specifica.

Questo esempio utilizza le seguenti variabili:

• PROJECT_ID: il tuo progetto Google Cloud.
• INSTANCE_ID: il nome dell'istanza a cui vuoi concedere accesso.
• SERVICE_ACCOUNT_EMAIL: l'indirizzo email completo dell'account di servizio di cui vuoi modificare l'accesso.

1. Recupera le associazioni di criteri IAM esistenti e visualizzale nel file bindings.json:

gcloud projects get-iam-policy PROJECT_ID --format=json > bindings.json

2. Aggiungi la seguente associazione di ruolo condizionale al file bindings.json:

   {
     "bindings": [
       {
         "role": "roles/cloudsql.client",
         "members": [
           "serviceAccount:SERVICE_ACCOUNT_EMAIL"
         ],
         "condition": {
           "expression": "resource.name == 'projects/PROJECT_ID/instances/INSTANCE_ID'
             && resource.service == 'sqladmin.googleapis.com'"
         }
       }
     ],
     "etag": "BwWKmjvelug=",
     "version": 3
   }

3. Aggiorna il criterio IAM con il nuovo file bindings.json.

   gcloud projects set-iam-policy PROJECT_ID bindings.json

Terraform

Per consentire agli utenti di connettersi a istanze specifiche, utilizza una risorsa dati Terraform google_iam_policy e una google_project_iam_policy risorsa Terraform.

data "google_iam_policy" "sql_iam_policy" {
  binding {
    role = "roles/cloudsql.client"
    members = [
      "serviceAccount:${google_project_service_identity.gcp_sa_cloud_sql.email}",
    ]
    condition {
      expression  = "resource.name == 'projects/${data.google_project.project.project_id}/instances/${google_sql_database_instance.default.name}' && resource.type == 'sqladmin.googleapis.com/Instance'"
      title       = "created"
      description = "Cloud SQL instance creation"
    }
  }
}

resource "google_project_iam_policy" "project" {
  project     = data.google_project.project.project_id
  policy_data = data.google_iam_policy.sql_iam_policy.policy_data
}

Applica le modifiche

Per applicare la configurazione Terraform in un progetto Google Cloud, completa i passaggi nelle seguenti sezioni.

Prepara Cloud Shell

1. Avvia Cloud Shell.

2. Imposta il progetto Google Cloud predefinito in cui vuoi applicare le configurazioni Terraform.

   Devi eseguire questo comando una sola volta per progetto e puoi farlo in qualsiasi directory.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   Le variabili di ambiente vengono sostituite se imposti valori espliciti nel file di configurazione Terraform.

Prepara la directory

Ogni file di configurazione di Terraform deve avere una propria directory (chiamata anche modulo principale).

1. In Cloud Shell, crea una directory e un nuovo file al suo interno. Il nome file deve avere l'estensione .tf, ad esempio main.tf. In questo tutorial, il file è denominato main.tf.

   mkdir DIRECTORY && cd DIRECTORY && touch main.tf

2. Se stai seguendo un tutorial, puoi copiare il codice campione in ogni sezione o passaggio.

   Copia il codice campione nel main.tf appena creato.

   Se vuoi, copia il codice da GitHub. Questa opzione è consigliata quando lo snippet Terraform fa parte di una soluzione end-to-end.

3. Esamina e modifica i parametri di esempio da applicare al tuo ambiente.
4. Salva le modifiche.
5. Inizializza Terraform. Devi eseguire questa operazione una sola volta per directory.

   terraform init

   Se vuoi, per utilizzare la versione più recente del provider Google, includi l'opzione -upgrade:

   terraform init -upgrade

Applica le modifiche

1. Rivedi la configurazione e verifica che le risorse che Terraform sta per creare o aggiornare corrispondano alle tue aspettative:

   terraform plan

   Apporta le correzioni necessarie alla configurazione.

2. Applica la configurazione di Terraform eseguendo il seguente comando e inserendo yes al prompt:

   terraform apply

   Attendi che Terraform mostri il messaggio "Applicazione completata".

3. Apri il tuo progetto Google Cloud per visualizzare i risultati. Nella console Google Cloud, vai alle risorse nell'interfaccia utente per assicurarti che Terraform le abbia create o aggiornate.

Elimina le modifiche

Per eliminare le modifiche:

1. Per disattivare la protezione dell'eliminazione, imposta l'argomento deletion_protection su false nel file di configurazione Terraform.

   deletion_protection =  "false"

2. Applica la configurazione Terraform aggiornata eseguendo il seguente comando e inserendo yes al prompt:

   terraform apply

3. Rimuovi le risorse applicate in precedenza con la configurazione Terraform eseguendo il seguente comando e inserendo yes al prompt:

   terraform destroy

Console

1. Nella console Google Cloud, vai alla pagina IAM.

   Vai a IAM

2. Fai clic sulla scheda PRINCIPALI.
3. Individua l'indirizzo email o l'account di servizio (principale) dell'utente a cui vuoi limitare l'accesso.
4. Fai clic sull'icona Modifica entità a destra dell'entità. Questa icona ha la forma di una matita.
5. Nella finestra di dialogo Modifica autorizzazioni, fai clic su AGGIUNGI UN ALTRO RUOLO.

6. Nel campo Filtro della finestra di dialogo successiva, inserisci Cloud SQL Admin. Quindi, seleziona il ruolo Amministratore Cloud SQL visualizzato.

   La finestra di dialogo Modifica autorizzazioni è attiva e il ruolo Amministratore Cloud SQL viene visualizzato nella finestra di dialogo.

7. A destra del ruolo Amministratore Cloud SQL, fai clic sul link Aggiungi condizione.
8. Nella finestra di dialogo Modifica condizione, fornisci le seguenti informazioni:
   1. Nel campo Titolo, inserisci un nome per la condizione che stai aggiungendo per limitare l'accesso alle operazioni di backup per le istanze di test. Ad esempio, puoi inserire Limit access to backup operations.

   2. Fai clic sulla scheda EDITOR CONDIZIONI e poi aggiungi la seguente condizione:

      resource.type == "sqladmin.googleapis.com/BackupRun" && 
      resource.name.startsWith("projects/PROJECT_ID/instances/test")
          

9. Fai clic su SALVA.
10. Nella finestra di dialogo Modifica autorizzazioni, fai clic su SALVA.

gcloud

Questo esempio utilizza le seguenti variabili:

• PROJECT_ID: il tuo progetto Google Cloud.
• USER_EMAIL: l'indirizzo email dell'utente.
• SERVICE_ACCOUNT_EMAIL:l'indirizzo email completo dell'account di servizio di cui vuoi limitare l'accesso.

1. Limita l'ambito del ruolo cloudsql.admin per un utente con indirizzo email USER_EMAIL.

   L'ambito del ruolo è limitato alle risorse i cui nomi iniziano con projects/PROJECT_ID/instances/test.

   gcloud projects add-iam-policy-binding PROJECT_ID \ --member=user:USER_EMAIL \
   --role=roles/cloudsql.admin \
   --condition=expression="resource.type == \"sqladmin.googleapis.com/BackupRun\" && resource.name.startsWith(\"projects/PROJECT_ID/instances/test-instance-1\")",title="test"
       

OR

2. Limita l'ambito del ruolo cloudsql.admin per un utente che ha eseguito l'accesso con un account di servizio di SERVICE_ACCOUNT_EMAIL.

   gcloud projects add-iam-policy-binding PROJECT_ID \ --member=serviceAccount:SERVICE_ACCOUNT_EMAIL \
   --role=roles/cloudsql.admin \
   --condition=expression="resource.type == \"sqladmin.googleapis.com/BackupRun\" && resource.name.startsWith(\"projects/PROJECT_ID/instances/test-instance-1\")",title="test"
       

Console

1. Nella console Google Cloud, vai alla pagina IAM.

   Vai a IAM

2. Fai clic su Aggiungi.
3. Nel campo Nuovi membri, inserisci l'indirizzo email dell'account di servizio.
4. Fai clic sull'elenco a discesa Ruolo e seleziona il ruolo Editor Cloud SQL. Non aggiungere altro per questo ruolo.
5. Fai clic su Salva per salvare la condizione.
6. Fai clic sul menu Ruolo per lo stesso account e seleziona il ruolo Amministratore Cloud SQL.
7. Fai clic su Aggiungi condizione.
8. Inserisci un titolo e una descrizione.
9. Seleziona la scheda Editor delle condizioni.
10. Nella sezione Generatore di condizioni:
    • In Tipo di condizione - Risorsa - Nome, inserisci un nome per la condizione.
    • In Tipo di condizione - Risorsa - Servizio, seleziona sqladmin.googleapis.com.
    • In Tipo di condizione - Risorsa - Tag, inserisci il nome con spazio dei nomi della chiave Tag. Per questo esempio, l'operatore è matches e il valore è 815471563813/env/test.
11. Fai clic su Salva per salvare la condizione.
12. Fai clic su Salva per salvare il criterio.

gcloud

Questo esempio utilizza le seguenti variabili:

• PROJECT_ID: il tuo progetto Google Cloud.
• INSTANCE_ID: la tua istanza Cloud SQL.
• REGION: la regione in cui si trova l'istanza Cloud SQL.
• ORGANIZATION_ID: l'ID dell'organizzazione che deve essere la risorsa principale di questa chiave tag; ad esempio: 12345678901. Per scoprire come ottenere l'ID della tua organizzazione, consulta Creare e gestire le organizzazioni.
• SERVICE_ACCOUNT_EMAIL:l'indirizzo email completo dell'account di servizio di cui vuoi modificare l'accesso.

1. Crea una chiave tag denominata "env" con i valori tag "prod" e "test". Per ulteriori informazioni, consulta Creazione e definizione di un nuovo tag.

   gcloud alpha resource-manager tags keys create env \
   --parent=organizations/ORGANIZATION_ID
   gcloud alpha resource-manager tags values create prod \
   --parent=env
   gcloud alpha resource-manager tags values create test \
   --parent=env
       

2. Collega il tag "env" con valore "test" alle istanze Cloud SQL dell'ambiente di test. Per ulteriori informazioni, consulta la pagina Tag Cloud SQL.

gcloud alpha resource-manager tags bindings create \
--tag-value=test \
--parent=//sqladmin.googleapis.com/projects/PROJECT_ID/instances/INSTANCE_ID \
--location=REGION
  

3. Recupera le associazioni di criteri IAM esistenti e visualizzale nel file bindings.json:

   gcloud projects get-iam-policy PROJECT_ID --format=json >> bindings.json

4. Aggiungi le seguenti associazioni condizionali al file bindings.json:

   {
     "bindings": [
       {
         "role": "roles/cloudsql.editor",
         "members": [
             "serviceAccount:SERVICE_ACCOUNT_EMAIL"
           ]
       },
       {
         "role": "roles/cloudsql.admin",
         "members": [
             "serviceAccount:SERVICE_ACCOUNT_EMAIL"
           ],
         "condition": {
           "expression": "resource.matchTag('ORGANIZATION_ID/env', 'test')"
         }
       }
     ],
     "etag": "BwWKmjvelug="
     "version": 3
   }

5. Aggiorna le associazioni dei criteri IAM con il nuovo file bindings.json.

   gcloud projects set-iam-policy PROJECT_ID bindings.json