Questa pagina è stata tradotta dall'API Cloud Translation.

Impostazione del controllo degli accessi in una configurazione

Per controllare l'accesso alle tue risorse in Google Cloud, devi utilizzare Identity and Access Management (IAM). Con IAM puoi impostare le autorizzazioni specificando chi ha quale tipo di accesso a quali risorse del tuo progetto. Per un'introduzione a IAM, consulta la panoramica di IAM.

Quando esegui il deployment delle risorse, puoi anche controllare chi ha accesso a tali risorse impostando un criterio IAM nella priorità nella configurazione. Ad esempio, se prevedi di creare argomenti Pub/Sub che possono essere gestiti da utenti specifici, puoi esprimerli in Deployment Manager specificando un criterio IAM nella configurazione. Quando crei o aggiorni il deployment, Deployment Manager chiama l'API IAM per impostare le autorizzazioni appropriate per la risorsa.

Prima di iniziare

Se vuoi utilizzare gli esempi a riga di comando in questa guida, installa lo strumento a riga di comando gcloud.
Se vuoi utilizzare gli esempi di API in questa guida, configura l'accesso API.

Utilizzo dei criteri IAM in Deployment Manager

Un criterio IAM è una raccolta di utenti e dei relativi ruoli. Puoi impostare un criterio IAM a livello di progetto utilizzando i ruoli di base o predefiniti. Alcuni servizi, come Cloud Pub/Sub, supportano anche l'impostazione di criteri IAM a livello di risorsa.

Se un servizio non supporta l'impostazione di criteri IAM a livello di risorsa, Deployment Manager restituisce un errore NO_METHOD_TO_UPDATE_ACCESS_CONTROL.

Per un elenco dei ruoli e delle risorse a cui puoi applicarli, consulta la sezione Informazioni sui ruoli.

Concessione dell'autorizzazione Deployment Manager per impostare i criteri IAM

Deployment Manager utilizza l'account di servizio delle API di Google per chiamare altre API di Google e gestire le risorse di Google Cloud per conto tuo. Devi concedere al ruolo di servizio delle API di Google del tuo progetto il ruolo roles/owner di base in modo che possa applicare i criteri IAM definiti nelle configurazioni.

Vai alla pagina IAM nella console Google Cloud del progetto.
Vai alla pagina IAM
Se richiesto, seleziona il progetto nell'elenco.
Cerca l'account di servizio delle API di Google, che ha l'indirizzo email nel seguente formato:
```
[PROJECT_NUMBER]@cloudservices.gserviceaccount.com
```
Nota: questo indirizzo email richiede il numero di progetto, non l'ID progetto. Per informazioni su come identificare il numero di progetto, consulta Identificazione dei progetti.
Concedi all'account di servizio delle API i ruoli roles/owner:
console
1. Sempre nella console Google Cloud, espandi il menu a discesa Ruoli per l'account di servizio delle API Google e seleziona Progetto > Proprietario.
2. Fai clic su Salva per salvare le modifiche.
gcloud
Con Google Cloud CLI, aggiungi un'associazione al criterio IAM per il progetto:
```
gcloud projects add-iam-policy-binding [PROJECT_ID] \
    --member serviceAccount:[SERVICE_ACCOUNT_EMAIL] --role roles/owner
```
dove:
- [PROJECT_ID] è l'ID del progetto.
- [SERVICE_ACCOUNT_EMAIL] è l'indirizzo email dell'account di servizio.
Ad esempio:
```
gcloud projects add-iam-policy-binding database-images \
    --member serviceAccount:123456789012@cloudservices.gserviceaccount.com  \
    --role roles/owner
```
Server
Nell'API, effettua una richiesta POST al seguente URL, dove [PROJECT_ID] è l'ID del progetto:
```
POST https://cloudresourcemanager.googleapis.com/v1/projects/$[PROJECT_ID]:setIamPolicy
```
Il corpo della richiesta deve contenere l'elenco delle associazioni che vuoi applicare al progetto. Il ruolo roles/owner dovrebbe far parte dell'associazione. Ad esempio:
```
{
    "policy": {
        "version": "0",
        "bindings": [
            {
                "role": "roles/owner",
                "members": [
                    "user:example@gmail.com",
                    "serviceAccount:123456789012@cloudservices.gserviceaccount.com"
                ]
            }
        ]
    }
}
```

Impostare un criterio IAM nella configurazione

Quindi, nella configurazione o nel modello, puoi impostare un criterio IAM seguendo queste istruzioni:

Aggiungi la sezione accessControl alla configurazione di primo livello per ogni risorsa a cui vuoi applicare i criteri di controllo dell'accesso.
Specifica il valore gcpIamPolicy che preferisci per la risorsa. Ogni criterio IAM può contenere un elenco di associazioni. Ogni associazione collega un elenco di membri a un ruolo.

Nota: se utilizzi la sezione accessControl per concedere ruoli agli account, inclusi quelli di servizio, ti consigliamo di utilizzare Deployment Manager per gestire i ruoli per tale account. Se cambi i ruoli dell'account al di fuori di Deployment Manager e poi aggiorni il deployment originale, i ruoli della configurazione di deployment vengono applicati all'account.

Se utilizzi accessControl per gestire gli account di servizio, scopri di più sulla gestione degli account di servizio.

Ad esempio, la seguente sezione accessControl aggiunge associazioni che concedono questi ruoli agli utenti:

Utente	Ruolo
`alice@example.com`	`roles/pubsub.editor`
`my-other-app@appspot.gserviceaccount.com` `jane@example.com`	`roles/pubsub.publisher`

resources:
- name: a-new-pubsub-topic
  type: pubsub.v1.topic
  properties:
    ...

  accessControl:
    gcpIamPolicy:
      bindings:
      - role: roles/pubsub.editor
        members:
        - "user:alice@example.com"
      - role: roles/pubsub.publisher
        members:
        - "user:jane@example.com"
        - "serviceAccount:my-other-app@appspot.gserviceaccount.com"

Per ulteriori informazioni sui criteri IAM, leggi la documentazione di IAM.