Controllo dell'accesso con IAM

In questa pagina vengono descritte le autorizzazioni per controllare l'accesso a Container Registry.

Dopo aver configurato le autorizzazioni, puoi configurare authentication per i client Docker che utilizzi per eseguire il push e il pull delle immagini.

Se utilizzi Artifact Analysis per lavorare con i metadati del container, come le vulnerabilità trovate nelle immagini, consulta Documentazione di Artifact Analysis per informazioni sulla concessione dell'accesso per visualizzare o gestire i metadati.

Prima di iniziare

Verifica di disporre delle autorizzazioni per gestire gli utenti. Devi disporre delle autorizzazioni in uno dei seguenti ruoli:

  • Amministratore IAM progetto (roles/resourcemanager.projectIamAdmin)
  • Amministratore sicurezza (roles/iam.securityAdmin)

In alternativa alla concessione di questi ruoli, puoi utilizzare una ruolo personalizzato o ruolo predefinito con lo stesso autorizzazioni aggiuntive.

Autorizzazioni e ruoli

Tutti gli utenti, gli account di servizio e altre identities che interagiscono con Container Registry, devono disporre Autorizzazioni IAM (Identity and Access Management) per Cloud Storage.

  • Servizi Google Cloud che in genere accedono a Container Registry sono configurate con autorizzazioni predefinite per i registry progetto Google Cloud. Se le autorizzazioni predefinite non soddisfano le tue esigenze, devi configurare le autorizzazioni appropriate.
  • Per le altre identità, devi configurare le autorizzazioni richieste.

Puoi controllare l'accesso agli host di Container Registry con le autorizzazioni di Cloud Storage. Nella tabella seguente sono elencate le Ruoli di Cloud Storage con delle autorizzazioni richieste da Container Registry.

Sono necessarie alcune autorizzazioni aggiuntive durante la visualizzazione di Container Registry utilizzando la console Google Cloud, consulta Autorizzazioni comuni richieste per l'utilizzo della console Cloud.

Accesso richiesto Ruolo Dove concedere le autorizzazioni
Esegui il pull delle immagini (sola lettura) da un registro esistente Visualizzatore oggetti Storage (roles/storage.objectViewer) Concedi il ruolo nel bucket di archiviazione del registry.
Esegui il push (scrittura) delle immagini e il pull (lettura) delle immagini da un host del registro esistente in un progetto Writer bucket legacy Storage (roles/storage.legacyBucketWriter) Concedi il ruolo nel bucket di archiviazione del registry. Questa autorizzazione è disponibile disponibile a livello di bucket, non puoi concederla a livello di progetto.
Aggiungi host del registro ai progetti Google Cloud e crea di archiviazione dei bucket associati. Amministratore Storage (roles/storage.admin) Concedi il ruolo a livello di progetto

Il push delle immagini richiede le autorizzazioni di lettura e scrittura degli oggetti, nonché Autorizzazione storage.buckets.get. Il ruolo Writer bucket legacy Storage include le autorizzazioni richieste in un singolo ruolo di Cloud Storage, non concede il controllo completo su bucket e oggetti di archiviazione.

Il ruolo Amministratore Storage concede il controllo completo sui bucket e sugli oggetti di archiviazione. Se concedi questa autorizzazione a livello di progetto, l'entità ha accesso a tutti i bucket di archiviazione nel progetto, inclusi quelli non utilizzati e Container Registry. Valuta attentamente quali entità richiedono questo ruolo.

  • Per impostazione predefinita, l'account di servizio Cloud Build autorizzazioni nel ruolo Amministratore Storage. Questo account di servizio può quindi aggiungere registri al progetto principale con il primo push e push di immagini a quelli esistenti dei registri nel suo progetto principale.
  • Se utilizzi Docker o altri strumenti per creare ed eseguire il push delle immagini in un registro, valuta la possibilità di aggiungere registri al tuo progetto utilizzando un account con il ruolo permissivo Amministratore Storage e poi concedi a Storage Writer di bucket legacy o Ruoli Visualizzatore oggetti Storage ad altri account che devono eseguire il push o il pull in formato Docker.

Per ulteriori informazioni su ruoli e autorizzazioni di Cloud Storage, consulta Documentazione di Cloud Storage.

Concedi autorizzazioni IAM

Container Registry utilizza i bucket Cloud Storage come l'archiviazione sottostante per le immagini container. Sei tu a controllare l'accesso alle immagini concedendo al bucket le autorizzazioni per un registry.

Il primo push dell'immagine a un nome host aggiunge l'host del registro e il relativo spazio di archiviazione in un progetto. Ad esempio, il primo push a gcr.io/my-project aggiunge l'host del registry gcr.io al progetto con ID progetto my-project e crea un bucket di archiviazione per il registro. Il nome del bucket contiene uno dei seguenti formati:

  • artifacts.PROJECT-ID.appspot.com per le immagini archiviate sull'host gcr.io
  • STORAGE-REGION.artifacts.PROJECT-ID.appspot.com per le immagini archiviate su altri host del registry

Per eseguire correttamente questo primo push dell'immagine, l'account che lo esegue devono disporre delle autorizzazioni nel ruolo Amministratore Storage.

Dopo il push iniziale dell'immagine a un host del registro, concedi di accesso al bucket di archiviazione del registry per controllare l'accesso alle immagini nel registro:

  • Writer bucket legacy Storage di cui eseguire il push e il pull
  • Visualizzatore oggetti Storage di cui eseguire solo il pull

Puoi concedere l'autorizzazione per un bucket utilizzando la console Google Cloud o lo strumento a riga di comando gsutil.

Limitazioni e restrizioni

Puoi concedere autorizzazioni solo a livello di bucket di archiviazione per di Container Registry.

  • Container Registry ignora le autorizzazioni impostate sui singoli oggetti all'interno di in un bucket Cloud Storage.
  • Non puoi concedere autorizzazioni per i repository all'interno di un registro. Se hai bisogno controllo dell'accesso più granulare, Artifact Registry fornisce dell'controllo dell'accesso a livello di repository e potrebbe soddisfare meglio le tue esigenze.
  • Se abiliti l'accesso uniforme a livello di bucket per qualsiasi bucket di archiviazione di Container Registry, devi concedere in modo esplicito autorizzazioni per tutti gli utenti e gli account di servizio che accedono ai registri. Nel in questo caso, i ruoli Proprietario ed Editor potrebbero non concedere le autorizzazioni necessarie.

Concedi le autorizzazioni

  1. Se l'host del registry non esiste ancora nel progetto, viene creato un account con autorizzazioni nel ruolo Amministratore Storage devi eseguire il push della prima immagine nel registro. Viene creato il bucket di archiviazione per l'host del registry.

    Cloud Build dispone delle autorizzazioni necessarie per eseguire l'immagine iniziale eseguire il push all'interno dello stesso progetto. Se esegui il push delle immagini con un altro strumento, verifica le autorizzazioni per l'account Google Cloud in uso per l'autenticazione con Container Registry.

    Per ulteriori informazioni sul push dell'immagine iniziale con Docker, consulta Aggiunta di un registro.

  2. Nel progetto con Container Registry, concedi le autorizzazioni appropriate sul bucket Cloud Storage utilizzato dall'host del registro.

    Console

    1. Vai alla pagina di Cloud Storage nella console Google Cloud.
    2. Fai clic sul link artifacts.PROJECT-ID.appspot.com oppure STORAGE-REGION.artifacts.PROJECT-ID.appspot.com per il bucket.

      Sostituisci PROJECT-ID con Google Cloud ID progetto del progetto che ospita Container Registry STORAGE-REGION con la strategia multiregionale (asia, eu o us) del registro che ospita l'immagine.

    3. Seleziona la scheda Autorizzazioni.

    4. Fai clic su Aggiungi.

    5. Nel campo Entità, inserisci gli indirizzi email degli account che richiedono l'accesso, separati da virgole. Questo l'indirizzo email può essere uno dei seguenti:

      • Un Account Google (ad es. someone@example.com)
      • Un gruppo Google (ad esempio my-developer-team@googlegroups.com)
      • Un account di servizio IAM.

        Visualizza l'elenco dei servizi Google Cloud. che in genere accedono ai registry per trovare l'indirizzo email l'account di servizio associato. Se il servizio è in esecuzione diverso rispetto a Container Registry, assicurati di utilizzare l'indirizzo email dell'account di servizio nel in un altro progetto.

    6. Nel menu a discesa Seleziona un ruolo, seleziona la Cloud Storage, quindi seleziona l'autorizzazione appropriata.

      • Visualizzatore oggetti Storage per eseguire solo il pull delle immagini
      • Autore di bucket Storage legacy per eseguire il push e il pull delle immagini
    7. Fai clic su Aggiungi.

    gsutil

    1. Esegui questo comando per elencare i bucket nel progetto:

      gsutil ls
      

      La risposta è simile al seguente esempio:

      gs://[BUCKET_NAME1]/
      gs://[BUCKET_NAME2]/
      gs://[BUCKET_NAME3]/ ...
      

      Trova il bucket per l'host del registry nell'elenco dei bucket restituito. Il bucket in cui sono archiviate le tue immagini è denominato BUCKET-NAME in uno dei seguenti formati:

      • artifacts.PROJECT-ID.appspot.com per le immagini archiviate sull'host gcr.io
      • STORAGE-REGION.artifacts.PROJECT-ID.appspot.com per le immagini archiviate su altri host del registry

      Dove

      • PROJECT-ID è il tuo account Google Cloud ID progetto.
      • STORAGE-REGION è la località del bucket di archiviazione:
        • us per i registri nell'host us.gcr.io
        • eu per i registri nell'host eu.gcr.io
        • asia per i registri nell'host asia.gcr.io
    2. Esegui questo comando nella shell o nella finestra del terminale:

      gsutil iam ch TYPE:EMAIL-ADDRESS:ROLE gs://BUCKET_NAME
      

      Dove

      • TYPE può essere uno dei seguenti:
        • serviceAccount, se EMAIL-ADDRESS specifica un account di servizio.
        • user, se EMAIL-ADDRESS è un Account Google.
        • group, se EMAIL-ADDRESS è un gruppo Google.
      • EMAIL-ADDRESS può essere uno dei seguenti:

        • Un Account Google (ad es. someone@example.com)
        • Un gruppo Google (ad esempio my-developer-team@googlegroups.com)
        • Un account di servizio IAM.

          Visualizza l'elenco dei servizi Google Cloud. che in genere accedono ai registry per trovare l'indirizzo email l'account di servizio associato. Se il servizio è in esecuzione diverso rispetto a Container Registry, assicurati di utilizzare l'indirizzo email dell'account di servizio nel in un altro progetto.

      • ROLE è il ruolo di Cloud Storage che vuoi concedere.

        • objectViewer per estrarre le immagini
        • Immagini push e pull di legacyBucketWriter
      • BUCKET_NAME è il nome dell'account Cloud Storage bucket nel modulo artifacts.PROJECT-ID.appspot.com o STORAGE-REGION.artifacts.PROJECT-ID.appspot.com

    Ad esempio, questo comando concede all'account di servizio my-account@my-project.iam.gserviceaccount.com con autorizzazioni per esegui il push e il pull delle immagini nel bucket my-example-bucket:

    gsutil iam ch \
      serviceAccount:my-account@my-project.iam.gserviceaccount.com:legacyBucketWriter \
      gs://my-example-bucket
    

    Il comando gsutil iam ch modifica le autorizzazioni IAM di il bucket di archiviazione in cui è ospitato il registro. Altri esempi sono nella documentazione relativa a gsutil.

  3. Se stai configurando l'accesso per le VM di Compute Engine Nodi GKE che eseguono il push delle immagini in Container Registry, consulta Configurazione di VM e cluster per ulteriori informazioni passaggi di configurazione.

Configura l'accesso pubblico alle immagini

Container Registry è accessibile pubblicamente se la posizione del bucket di archiviazione sottostante è accessibile pubblicamente. All'interno di un progetto, tutte le immagini in ogni percorso host siano pubbliche o meno. All'interno dell'host di un progetto, non è possibile pubblicare immagini specifiche. Se hai immagini specifiche che vuoi rendere pubbliche:

  • Tienili in una posizione di hosting separata che rendi pubblica. o
  • Crea un nuovo progetto in cui conservare immagini accessibili pubblicamente.

Per gestire pubblicamente le immagini container, imposta lo spazio di archiviazione sottostante un bucket accessibile pubblicamente seguendo questa procedura:

  1. Assicurati di aver eseguito il push di un'immagine su Container Registry in modo che del bucket Cloud Storage sottostante.

  2. Trova il nome del bucket Cloud Storage per quel registro. Per farlo, elenca i bucket:

    gsutil ls
    

    L'URL del bucket di Container Registry sarà elencato come gs://artifacts.PROJECT-ID.appspot.com o gs://STORAGE-REGION.artifacts.PROJECT-ID.appspot.com, dove:

    • PROJECT-ID è il tuo account Google Cloud ID progetto. Progetti con ambito dominio avrà il nome di dominio come parte dell'ID progetto.
    • STORAGE-REGION è la località del bucket di archiviazione:
      • us per i registri nell'host us.gcr.io
      • eu per i registri nell'host eu.gcr.io
      • asia per i registri nell'host asia.gcr.io
  3. Rendi pubblico il bucket di archiviazione di Container Registry accessibile eseguendo questo comando. Questo comando ti consente tutte le immagini del bucket sono accessibili pubblicamente.

    gsutil iam ch allUsers:objectViewer gs://BUCKET-NAME
    

    dove:

    • gs://BUCKET-NAME è l'URL del bucket di Container Registry

Rimuovere l'accesso pubblico alle immagini

Console

  1. Assicurati di aver eseguito il push di un'immagine su Container Registry in modo che del bucket Cloud Storage sottostante.

  2. Apri la pagina Container Registry nella console Google Cloud.

    Apri la pagina di Container Registry

  3. Nel riquadro a sinistra, fai clic su Impostazioni.

  4. Nella pagina Impostazioni, in Accesso pubblico, attiva/disattiva la visibilità impostandola su Privato. Questa impostazione controlla l'accesso al bucket di archiviazione sottostante.

gsutil

  1. Trova il nome del bucket Cloud Storage per quel registro. Per farlo, elenca i bucket:

    gsutil ls
    

    L'URL del bucket di Container Registry sarà elencato come gs://artifacts.PROJECT-ID.appspot.com o gs://STORAGE-REGION.artifacts.PROJECT-ID.appspot.com, dove:

    • PROJECT-ID è la tua console Google Cloud ID progetto. Progetti con ambito dominio avrà il nome di dominio come parte dell'ID progetto.
    • STORAGE-REGION è la località del bucket di archiviazione:
      • us per i registri nell'host us.gcr.io
      • eu per i registri nell'host eu.gcr.io
      • asia per i registri nell'host asia.gcr.io
  2. Per rimuovere l'accesso pubblico al bucket di archiviazione, esegui questo comando nella shell o nella finestra del terminale:

    gsutil iam ch -d allUsers:objectViewer gs://BUCKET-NAME
    

dove:

  • BUCKET-NAME è il nome del bucket desiderato

Revoca autorizzazioni

Per revocare le autorizzazioni IAM, segui questi passaggi.

Console

  1. Visita la pagina di Cloud Storage nella console Google Cloud.
  2. Fai clic sul link artifacts.PROJECT-ID.appspot.com oppure STORAGE-REGION.artifacts.PROJECT-ID.appspot.com per il bucket. In questo caso, PROJECT-ID è il ID progetto Google Cloud del progetto che ospita Container Registry STORAGE-REGION corrisponde a più regioni (asia, eu o us) della nel registro che ospita l'immagine.

  3. Seleziona la scheda Autorizzazioni.

  4. Fai clic sull'icona del cestino accanto all'entità da rimuovere.

gsutil

Esegui questo comando nella shell o nella finestra del terminale:

gsutil iam ch -d PRINCIPAL gs://BUCKET-NAME

dove:

  • PRINCIPAL può essere uno dei seguenti:
    • user:EMAIL-ADDRESS per un Account Google
    • serviceAccount:EMAIL-ADDRESS per un account di servizio IAM
    • group:EMAIL-ADDRESS per un gruppo Google.
    • allUsers per la revoca dell'accesso pubblico
  • BUCKET-NAME è il nome del bucket desiderato

Esegui l'integrazione con i servizi Google Cloud

Per la maggior parte degli account di servizio Google Cloud, la configurazione dell'accesso a un registro richiede solo la concessione delle autorizzazioni IAM appropriate.

Autorizzazioni predefinite per i servizi Google Cloud

I servizi Google Cloud come Cloud Build o Google Kubernetes Engine utilizzano account di servizio predefinito o un agente di servizio usato per interagire all'interno dello stesso progetto.

Devi configurare o modificare le autorizzazioni personalmente se:

  • Il servizio Google Cloud si trova in un progetto diverso da Container Registry.
  • Le autorizzazioni predefinite non soddisfano le tue esigenze. Ad esempio, il valore predefinito l'account di servizio Compute Engine ha accesso di sola lettura allo spazio di archiviazione nello stesso progetto. Se vuoi eseguire il push di un'immagine dalla VM a un registro, devi modificare le autorizzazioni per l'account di servizio della VM o eseguire l'autenticazione nel registro con un account con accesso in scrittura allo spazio di archiviazione.
  • Stai utilizzando un account di servizio personalizzato per interagire con Container Registry

I seguenti account di servizio in genere accedono a Container Registry. La l'indirizzo email dell'account di servizio include Google Cloud ID o numero di progetto del progetto in cui è in esecuzione il servizio.

Servizio Account di servizio Indirizzo email Autorizzazioni
Ambiente flessibile di App Engine Account di servizio predefinito di App Engine PROJECT-ID@appspot.gserviceaccount.com Ruolo Editor, può leggere e scrivere nello spazio di archiviazione
Compute Engine Account di servizio predefinito Compute Engine PROJECT-NUMBER-compute@developer.gserviceaccount.com Ruolo Editor, limitato all'accesso di sola lettura allo spazio di archiviazione
Cloud Build Account di servizio Cloud Build PROJECT-NUMBER@cloudbuild.gserviceaccount.com Autorizzazioni predefinite includono la creazione di bucket di archiviazione e l'accesso in lettura e scrittura allo spazio di archiviazione.
Cloud Run Account di servizio predefinito Compute Engine
L'account di servizio di runtime predefinito per le revisioni.
PROJECT-NUMBER-compute@developer.gserviceaccount.com Ruolo Editor, limitato all'accesso di sola lettura allo spazio di archiviazione
GKE Account di servizio predefinito Compute Engine
L'account di servizio predefinito per i nodi.
PROJECT-NUMBER-compute@developer.gserviceaccount.com Ruolo Editor, limitato all'accesso di sola lettura allo spazio di archiviazione

Configura VM e cluster per il push delle immagini

Compute Engine e qualsiasi servizio Google Cloud che utilizzi Compute Engine ha un account di servizio predefinito Compute Engine come identità predefinita.

Sia le autorizzazioni IAM sia gli ambiti di accesso VM per leggere e scrivere nello spazio di archiviazione.

  • Le autorizzazioni IAM determinano l'accesso a una risorsa.
  • Gli ambiti di accesso determinano ambiti OAuth predefiniti per le richieste effettuate tramite gcloud CLI e client su un'istanza VM. Di conseguenza, gli ambiti di accesso possono limitare ulteriormente accesso ai metodi API durante l'autenticazione Credenziali predefinite dell'applicazione.
    • Per eseguire il pull di un'immagine privata, l'account di servizio della VM deve avere read per il bucket di archiviazione dell'immagine.
    • Per eseguire il push di immagini private, l'account di servizio della VM deve avere Ambito di accesso read-write, cloud-platform o full-control alla nel bucket di archiviazione dell'immagine.

L'account di servizio predefinito di Compute Engine ha il ruolo Editor che include le autorizzazioni per creare e aggiornare risorse per la maggior parte servizi Google Cloud. Tuttavia, sia per l'account di servizio predefinito un account di servizio personalizzato da associare a una VM, l'ambito di accesso predefinito per i bucket di archiviazione è di sola lettura. Ciò significa che, per impostazione predefinita, le VM non possono eseguire il push delle immagini.

Se intendi eseguire il deployment di immagini solo in ambienti come Compute Engine e GKE, non devi modificare l'ambito di accesso. Se se vuoi eseguire applicazioni in questi ambienti che eseguono il push delle immagini al registro, devi eseguire una configurazione aggiuntiva.

Le seguenti configurazioni richiedono modifiche a una delle autorizzazioni IAM o la configurazione dell'ambito di accesso.

Push di immagini da una VM o un cluster
Se vuoi eseguire il push delle immagini, l'account di servizio dell'istanza VM deve avere l'ambito storage-rw anziché storage-ro.
La VM e Container Registry si trovano in progetti separati
Devi concedere l'account di servizio con IAM per accedere al bucket di archiviazione utilizzato da Container Registry.
Esecuzione di comandi gcloud sulle VM
L'account di servizio deve avere l'ambito cloud-platform. Questo ambito concede autorizzazioni per eseguire il push e il pull delle immagini, nonché eseguire i comandi gcloud.

I passaggi per configurare gli ambiti sono descritti nelle sezioni seguenti.

Configura gli ambiti per le VM

Per impostare gli ambiti di accesso durante la creazione di una VM, utilizza l'opzione --scopes.

gcloud compute instances create INSTANCE --scopes=SCOPE

Dove

  • INSTANCE è il nome dell'istanza VM.
  • SCOPE è l'ambito che vuoi configurare per il servizio VM :
    • Esegui il pull delle immagini: storage-ro
    • Esegui il pull e il push delle immagini: storage-rw
    • Esegui il pull e il push delle immagini ed esegui i comandi gcloud: cloud-platform

Per modificare gli ambiti per un'istanza VM esistente:

Imposta l'ambito di accesso con l'opzione --scopes.

  1. Arresta l'istanza VM. Consulta Arresto di un'istanza.

  2. Modifica l'ambito di accesso con il comando seguente.

    gcloud compute instances set-service-account INSTANCE --scopes=SCOPE
    

    Dove

    • INSTANCE è il nome dell'istanza VM.
    • SCOPE è l'ambito che vuoi configurare per il servizio VM :
      • Esegui il pull delle immagini: storage-ro
      • Esegui il pull e il push delle immagini: storage-rw
      • Esegui il pull e il push delle immagini ed esegui i comandi gcloud: cloud-platform
  3. Riavvia l'istanza VM. Consulta Avvio di un'istanza arrestata.

Se vuoi utilizzare un account di servizio personalizzato per le VM anziché quello predefinito account di servizio, puoi specificare l'account di servizio e gli ambiti di accesso da utilizzare quando crea la VM o modifica le impostazioni della VM.

Configura gli ambiti per i cluster Google Kubernetes Engine

Per impostazione predefinita, i nuovi cluster GKE vengono creati delle autorizzazioni per i bucket Cloud Storage.

Per impostare lo spazio di archiviazione di read-write quando crei un cluster Google Kubernetes Engine, utilizza l'opzione --scopes. Ad esempio, il comando seguente crea un cluster con gli ambiti bigquery, storage-rw e compute-ro:

gcloud container clusters create example-cluster \
--scopes=bigquery,storage-rw,compute-ro

Per saperne di più sugli ambiti che puoi impostare quando crei un nuovo cluster, consulta la documentazione per il comando gcloud container clusters create.

Account di servizio Container Registry

L'agente di servizio Container Registry agisce per conto di Container Registry durante l'interazione con i servizi Google Cloud. Il servizio dispone dell'insieme minimo di autorizzazioni richieste se hai abilitato il API Container Registry dopo il 5 ottobre 2020. L'agente di servizio in precedenza disponeva del ruolo di Editor. Per ulteriori informazioni informazioni sull'agente di servizio e sulla modifica delle relative autorizzazioni, consulta Account di servizio di Container Registry.

Provalo

Se non hai mai utilizzato Google Cloud, crea un account per valutare in che modo Container Registry si comporta nel mondo reale diversi scenari. I nuovi clienti ricevono anche 300 $ di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.

Prova Container Registry gratuitamente