Configurare la federazione delle identità per i carichi di lavoro con le pipeline di deployment

La federazione delle identità per i workload consente alle pipeline di deployment di autenticarsi suGoogle Cloud utilizzando i token OpenID Connect (OIDC) per ottenere credenzialiGoogle Cloud di breve durata. Questo approccio ti aiuta a evitare l'overhead di manutenzione e i rischi per la sicurezza legati alla gestione delle chiavi dei service account.

Puoi configurare la federazione per le piattaforme di integrazione continua e distribuzione continua (CI/CD) come Azure DevOps, GitHub Actions, GitLab SaaS e HCP Terraform.

Prima di iniziare

  1. Verifica di disporre delle autorizzazioni necessarie per completare questa guida.

  2. Configurare l'autenticazione.

    Seleziona la scheda relativa al modo in cui prevedi di utilizzare gli esempi in questa pagina:

    Console

    Quando utilizzi la console Google Cloud per accedere ai servizi e alle API Google Cloud , non devi configurare l'autenticazione.

    gcloud

    Nella console Google Cloud , attiva Cloud Shell.

    Attiva Cloud Shell

    Nella parte inferiore della console Google Cloud , viene avviata una sessione di Cloud Shell e viene visualizzato un prompt della riga di comando. Cloud Shell è un ambiente shell con Google Cloud CLI già installata e con valori già impostati per il progetto corrente. L'inizializzazione della sessione può richiedere alcuni secondi.

    Python

    Per utilizzare gli esempi di Python in questa pagina in un ambiente di sviluppo locale, installa e inizializza gcloud CLI, quindi configura Credenziali predefinite dell'applicazione con le tue credenziali utente.

    1. Installa Google Cloud CLI.

    2. Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

    3. Se utilizzi una shell locale, crea credenziali di autenticazione locali per il tuo account utente:

      gcloud auth application-default login

      Non è necessario farlo se utilizzi Cloud Shell.

      Se viene restituito un errore di autenticazione e utilizzi un provider di identità (IdP) esterno, verifica di aver eseguito l'accesso a gcloud CLI con la tua identità federata.

    Per saperne di più, consulta Configura ADC per un ambiente di sviluppo locale nella documentazione sull'autenticazione di Google Cloud .

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per configurare la federazione delle identità per i workload, chiedi all'amministratore di concederti il ruolo IAM Amministratore pool di identità del workload (roles/iam.workloadIdentityPoolAdmin) sul progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

In alternativa, anche il ruolo di base Proprietario IAM (roles/owner) include le autorizzazioni per configurare la federazione delle identità. Non devi concedere ruoli di base in un ambiente di produzione, ma puoi concederli in un ambiente di sviluppo o di test.

Prepara l'IdP esterno

Azure DevOps

Per consentire a una pipeline Azure DevOps di autenticarsi su Google Cloud, devi prima configurare una connessione di servizio per Azure Resource Manager. Questa connessione consente alla pipeline di ottenere un token ID, che può poi scambiare con le credenzialiGoogle Cloud .

Per creare una connessione di servizio per Azure Resource Manager, segui questi passaggi:

  1. In Azure DevOps, apri il progetto e vai a Project Settings (Impostazioni progetto).
  2. Vai a Pipelines > Service connections.
  3. Fai clic su Crea connessione al servizio.
  4. Seleziona Azure Resource Manager.
  5. Fai clic su Avanti.
  6. Configura le seguenti impostazioni:

    • Tipo di identità: Registrazione di app (automatica)
    • Credenziale: Federazione delle identità per i workload
    • Livello di ambito: Abbonamento.

      Devi selezionare un abbonamento anche se non prevedi di utilizzare la connessione di servizio per accedere alle risorse Azure.

    • Nome connessione di servizio: inserisci un nome, ad esempio google-cloud.

  7. Fai clic su Salva.

  8. In Dettagli federazione delle identità per i workload, individua i seguenti identificatori:

    • Issuer: identifica in modo univoco la tua organizzazione Azure DevOps
    • Identificatore soggetto: identifica in modo univoco la connessione di servizio

    Salva questi identificatori per uno dei passaggi successivi.

Azure DevOps concede automaticamente l'accesso all'entità servizio della connessione di servizio all'abbonamento Azure selezionato. Ti consigliamo di ridurre questo accesso procedendo come segue:

  1. Fai clic su Gestisci i ruoli di servizio gestito.
  2. Fai clic su Assegnazioni di ruoli.
  3. Trova l'assegnazione del ruolo per la connessione di servizio e rimuovila o sostituiscila con un'assegnazione che utilizza un ruolo con meno privilegi.

GitHub Actions

Non è necessario apportare modifiche alla configurazione nel tuo account GitHub.

Dopo aver configurato un pool di identità del workload per considerare attendibile il tuo repository GitHub, puoi consentire ai workflow in quel repository di utilizzare il proprio token OIDC GitHub per ottenere credenziali Google Cloud di breve durata.

GitLab SaaS

Non è necessario apportare modifiche alla configurazione nel tuo account GitLab.

Dopo aver configurato un pool di identità del workload per considerare attendibile il tuo gruppo GitLab, puoi abilitare la federazione delle identità per i workload per i singoli job CI/CD.

HCP Terraform

Non è necessario apportare modifiche alla configurazione nel tuo account HCP Terraform.

Dopo aver configurato un pool di identità del workload per considerare attendibile HCP Terraform, puoi abilitare la federazione delle identità per i workload per i singoli spazi di lavoro.

Configura la federazione delle identità per i workload

Esegui questi passaggi per ogni progetto Azure DevOps, organizzazione GitHub, gruppo GitLab o organizzazione HCP Terraform.

Per iniziare a configurare la federazione delle identità per i workload, segui questi passaggi:

  1. Nella console Google Cloud , nella pagina di selezione del progetto, seleziona o crea un progetto Google Cloud .

    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 cui ti è stato concesso un ruolo.
    • Crea un progetto: per creare un progetto, devi disporre del ruolo Autore progetto (roles/resourcemanager.projectCreator), che contiene l'autorizzazione resourcemanager.projects.create. Scopri come concedere i ruoli.

    Vai al selettore di progetti

  2. È consigliabile utilizzare un progetto dedicato per gestire i pool e i provider di identità dei workload.
  3. Verifica che la fatturazione sia attivata per il tuo progetto Google Cloud .

  4. Abilita le API IAM, Resource Manager, Service Account Credentials e Security Token Service, se non sono già abilitate.

    Ruoli richiesti per abilitare le API

    Per abilitare le API, devi disporre dell'autorizzazione serviceusage.services.enable. Se hai creato il progetto, probabilmente disponi già di questa autorizzazione tramite il ruolo Proprietario (roles/owner). In caso contrario, puoi ottenere questa autorizzazione tramite il ruolo Amministratore Service Usage (roles/serviceusage.serviceUsageAdmin). Scopri come concedere i ruoli.

    Abilita le API

Definisci una mappatura degli attributi

Le credenziali specifiche dell'ambiente della pipeline di deployment possono contenere più attributi e devi decidere quale attributo utilizzare come identificatore del soggetto (google.subject) in Google Cloud.

Facoltativamente, puoi mappare altri attributi. Puoi quindi fare riferimento a questi attributi aggiuntivi quando concedi l'accesso alle risorse.

Azure DevOps

Il token ID Azure DevOps include un'attestazione sub che contiene l'identificatore del soggetto della connessione di servizio. L'identificatore del soggetto segue questo formato:

PREFIX/sc/SERVICE_CONNECTION

La lunghezza di questo identificatore del soggetto supera i 127 caratteri, ovvero la lunghezza massima consentita per google.subject. Per ovviare a questo limite, utilizza la seguente mappatura degli attributi:

google.subject=assertion.sub.split('/sc/')[1]

Questa mappatura utilizza la parte della rivendicazione sub che segue /sc/ come soggetto, che identifica in modo univoco la connessione al servizio. Quando concedi ruoli all'identità esterna, utilizza come soggetto la parte dell'identificatore soggetto che segue /sc/ (come mostrato nei dettagli della connessione di servizio).

GitHub Actions

Le mappature degli attributi possono utilizzare qualsiasi claim nel token OIDC di GitHub Actions. Queste chiavi di rivendicazione dei token e i relativi valori sono controllati da GitHub. Come minimo, devi mappare google.subject a assertion.sub, che corrisponde all'oggetto del token OIDC di GitHub Actions:

google.subject=assertion.sub

Il valore dell'oggetto del token OIDC di GitHub Actions può variare a seconda dell'evento di origine. Altri attributi delle rivendicazioni possono includere:

  • repository: contiene il nome del proprietario e del repository, ad esempio "google/guava".

  • repository_id: contiene l'ID repository univoco, ad esempio "20300177".

  • repository_owner: contiene il proprietario, che può essere un nome utente o il nome di un'organizzazione GitHub, ad esempio "google".

  • repository_owner_id: contiene l'ID proprietario univoco, ad esempio "1342004".

Questo elenco è un sottoinsieme delle rivendicazioni possibili. Per un elenco completo, consulta la documentazione di GitHub sulle rivendicazioni di esempio. Assicurati di mappare tutte le rivendicazioni che prevedi di utilizzare come condizioni degli attributi o come parte di una condizione principalSet futura.

GitLab SaaS

Le mappature degli attributi possono utilizzare le rivendicazioni incorporate nel token ID GitLab come attributi di origine, tra cui:

  • sub: il nome del progetto e il riferimento Git, ad esempio project_path:groupname/projectname:ref_type:branch:ref:main.
  • namespace_id: l'ID gruppo univoco.
  • project_id: l'ID progetto univoco.
  • user_id: l'ID utente univoco.
  • environment: l'ambiente a cui si applica il job.
  • ref_path: il riferimento Git, ad esempio refs/heads/main.

La seguente mappatura degli attributi imposta google.subject sull'attestazione sub dal token ID GitLab. Poiché l'attestazione sub contiene sia il nome del progetto sia il riferimento Git, questa mappatura ti consente di controllare l'accesso per repository e branch:

google.subject=assertion.sub

Controllare l'accesso per repository e branch può essere utile se determinati branch (ad esempio main) richiedono un accesso alle risorse diverso rispetto ad altri branch (ad esempio i branch delle funzionalità).

In alcuni casi, potrebbe essere sufficiente differenziare l'accesso solo per progetto o gruppo. La seguente mappatura include quindi due attributi aggiuntivi che contengono project_id e namespace_id di GitLab:

google.subject=assertion.sub
attribute.project_id=assertion.project_id
attribute.namespace_id=assertion.namespace_id

HCP Terraform

Le mappature degli attributi possono utilizzare le rivendicazioni incorporate nel token OIDC di HCP Terraform, tra cui:

  • terraform_organization_id: contiene l'ID univoco dell'organizzazione, ad esempio org-xxxxxxxxxxxxxxxx.
  • terraform_workspace_id: contiene l'ID univoco del workspace, ad esempio ws-xxxxxxxxxxxxxxxx.
  • terraform_workspace_name: contiene il nome visualizzato della workspace.
  • sub: contiene il nome visualizzato dell'organizzazione, dell'area di lavoro e della fase, ad esempio organization:example-org:workspace:example-workspace:run_phase:apply.

La seguente mappatura degli attributi imposta google.subject sulla rivendicazione terraform_workspace_id dal token OIDC HCP Terraform:

google.subject=assertion.terraform_workspace_id

Questa mappatura ti consente di controllare l'accesso alle risorse Google Cloud per workspace.

Definisci una condizione attributo

Le condizioni degli attributi sono espressioni CEL che possono controllare gli attributi di asserzione e gli attributi di destinazione. Se la condizione dell'attributo restituisce true per una determinata credenziale, la credenziale viene accettata. In caso contrario, la credenziale viene rifiutata. Devi avere una mappatura degli attributi per tutti i campi delle condizioni degli attributi.

Azure DevOps

Per limitare l'accesso alla tua applicazione Azure DevOps (entità di servizio), utilizza la seguente condizione dell'attributo:

assertion.oid=='APPLICATION_OBJECT_ID'

Sostituisci APPLICATION_OBJECT_ID con l'ID oggetto Entra dell'applicazione Azure DevOps.

GitHub Actions

Utilizza la seguente condizione dell'attributo per limitare l'accesso ai token emessi dalla tua organizzazione GitHub:

assertion.repository_owner=='ORGANIZATION'

Sostituisci ORGANIZATION con il nome della tua organizzazione GitHub.

Facoltativamente, estendi la condizione dell'attributo per limitare l'accesso a un sottoinsieme di workflow o rami. Ad esempio, la seguente condizione limita l'accesso ai workflow che utilizzano il branch Git main:

assertion.repository_owner=='ORGANIZATION' && assertion.ref=='refs/heads/main'

GitLab SaaS

Utilizza la seguente condizione dell'attributo per limitare l'accesso ai token emessi dal tuo gruppo GitLab

assertion.namespace_id=='GROUP_ID'

Sostituisci GROUP_ID con l'ID gruppo visualizzato nella home page del tuo gruppo GitLab.

Facoltativamente, estendi la condizione dell'attributo per limitare l'accesso a un sottoinsieme di progetti, rami o ambienti. Ad esempio, la seguente condizione limita l'accesso ai job che utilizzano l'ambiente production:

assertion.namespace_id=='GROUP_ID' && assertion.environment=='production'

HCP Terraform

Utilizza la seguente condizione dell'attributo per limitare l'accesso ai token emessi dalla tua organizzazione HCP Terraform:

assertion.terraform_organization_id=='ORGANIZATION_ID'

Sostituisci ORGANIZATION_ID con l'ID univoco della tua organizzazione, ad esempio org-xxxxxxxxxxxxxxxx. Facoltativamente, estendi la condizione dell'attributo per limitare l'accesso a un sottoinsieme di workflow o rami. Ad esempio, la seguente condizione dell'attributo limita l'accesso a un workspace specifico:

assertion.terraform_organization_id=='ORGANIZATION_ID' && assertion.terraform_workspace_id=='WORKSPACE_ID'

Crea il pool di identità del workload e il provider

Ora hai raccolto tutte le informazioni necessarie per creare un pool di identità del workload e un provider:

Console

  1. Nella console Google Cloud , vai alla pagina Nuovo provider e pool di workload.

    Vai a Nuovo provider e pool di workload

  2. In Crea un pool di identità, inserisci quanto segue:

    • Nome: il nome del pool. Il nome viene utilizzato anche come ID del pool. Non potrai modificare l'ID pool in un secondo momento.
    • Descrizione: testo che descrive lo scopo del pool.
  3. Fai clic su Continua.

  4. Configura le impostazioni del provider:

    Azure DevOps

    • Seleziona un provider: OpenID Connect (OIDC).
    • Nome provider: il nome del progetto Azure DevOps o un nome personalizzato.
    • ID provider: il nome del progetto Azure DevOps o un ID personalizzato. Non potrai modificare l'ID provider in un secondo momento.
    • URL emittente: l'emittente della connessione di servizio che hai cercato in precedenza.
    • Segmenti di pubblico: seleziona Segmenti di pubblico consentiti e inserisci il seguente valore:

      fb60f99c-7a34-4190-8149-302f77469936
      

      Questo ID è l'ID applicazione dell'endpoint di scambio di token Azure.

    GitHub Actions

    • Seleziona un provider: OpenID Connect (OIDC).
    • Nome provider: il nome del provider.
    • ID provider: ID del provider. Non potrai modificare l'ID provider in un secondo momento.
    • URL emittente: https://token.actions.githubusercontent.com/
    • Segmenti di pubblico: Segmento di pubblico predefinito

    GitLab SaaS

    • Seleziona un provider: OpenID Connect (OIDC).
    • Nome provider: il nome del provider.
    • ID provider: ID del provider. Non potrai modificare l'ID provider in un secondo momento.
    • URL emittente: https://gitlab.com
    • Segmenti di pubblico: Segmento di pubblico predefinito

    HCP Terraform

    • Seleziona un provider: OpenID Connect (OIDC).
    • Nome provider: il nome del provider.
    • ID provider: ID del provider. Non potrai modificare l'ID provider in un secondo momento.
    • URL emittente: https://app.terraform.io
    • Segmenti di pubblico: Segmento di pubblico predefinito
  5. Fai clic su Continua.

  6. In Configura attributi del provider, aggiungi le mappature degli attributi che hai identificato in precedenza.

  7. In Condizioni degli attributi, inserisci la condizione dell'attributo che hai identificato in precedenza.

  8. Fai clic su Salva per creare il pool di identità del workload e il provider.

gcloud

  1. Crea un nuovo pool di identità del workload:

    gcloud iam workload-identity-pools create POOL_ID \
        --location="global" \
        --description="DESCRIPTION" \
        --display-name="DISPLAY_NAME"
    

    Sostituisci i seguenti valori:

    • POOL_ID: l'ID univoco del pool
    • DISPLAY_NAME: il nome del pool
    • DESCRIPTION: la descrizione del pool. Questa descrizione viene visualizzata quando si concede l'accesso alle identità del pool
  2. Aggiungi un provider di pool di identità del workload:

    Azure DevOps

    gcloud iam workload-identity-pools providers create-oidc PROVIDER_ID \
        --location="global" \
        --workload-identity-pool="POOL_ID" \
        --issuer-uri="ISSUER" \
        --allowed-audiences="AUDIENCE" \
        --attribute-mapping="MAPPINGS" \
        --attribute-condition="CONDITIONS"
    

    Sostituisci i seguenti valori:

    GitHub Actions

    gcloud iam workload-identity-pools providers create-oidc PROVIDER_ID \
        --location="global" \
        --workload-identity-pool="POOL_ID" \
        --issuer-uri="https://token.actions.githubusercontent.com/" \
        --attribute-mapping="MAPPINGS" \
        --attribute-condition="CONDITIONS"
    

    Sostituisci i seguenti valori:

    GitLab SaaS

    gcloud iam workload-identity-pools providers create-oidc PROVIDER_ID \
        --location="global" \
        --workload-identity-pool="POOL_ID" \
        --issuer-uri="https://gitlab.com" \
        --attribute-mapping="MAPPINGS" \
        --attribute-condition="CONDITIONS"
    

    Sostituisci i seguenti valori:

    HCP Terraform

    gcloud iam workload-identity-pools providers create-oidc PROVIDER_ID \
        --location="global" \
        --workload-identity-pool="POOL_ID" \
        --issuer-uri="https://app.terraform.io" \
        --attribute-mapping="MAPPINGS" \
        --attribute-condition="CONDITIONS"
    

    Sostituisci i seguenti valori:

Aggiorna la condizione degli attributi su un provider di identità del workload

Questa sezione descrive come aggiornare la condizione dell'attributo su un provider di pool di identità del workload esistente per limitare l'accesso ai token emessi dalla tua organizzazione GitHub, dal tuo gruppo GitLab o dalla tua organizzazione HCP Terraform.

Per trovare la condizione dell'attributo consigliata per la tua pipeline, consulta Definisci una condizione dell'attributo.

Console

  1. Nella console Google Cloud , vai alla pagina Pool di identità del workload.

    Vai a Pool di identità del workload

  2. Trova il pool di identità del workload che contiene il provider, quindi fai clic sull'icona Espandi nodo per il pool.

  3. Trova il provider del pool di identità del workload che vuoi modificare e fai clic su Modifica.

  4. In Condizioni degli attributi, inserisci la condizione dell'attributo che hai identificato in precedenza.

  5. Per aggiornare il pool di identità del workload e il provider, fai clic su Salva.

gcloud

Per aggiornare il provider di pool di identità del workload, esegui questo comando:

gcloud iam workload-identity-pools providers update-oidc PROVIDER_ID \
    --location="global" \
    --workload-identity-pool="POOL_ID" \
    --attribute-condition="CONDITIONS"

Sostituisci i seguenti valori:

Autentica una pipeline di deployment

Devi eseguire questi passaggi per ogni workflow di GitHub Actions o spazio di lavoro di Terraform Cloud.

Consenti al tuo workload esterno di accedere alle risorse Google Cloud

Per fornire al tuo workload l'accesso alle risorse Google Cloud , ti consigliamo di concedere l'accesso diretto alle risorse all'entità. In questo caso, l'entità è l'utente federato. Alcuni prodotti Google Cloud hanno limiti API Google Cloud. Se il tuo workload chiama un endpoint API con una limitazione, puoi utilizzare la simulazione dell'identità dei account di servizio. In questo caso, l'entità è il service accountGoogle Cloud , che funge da identità. Concedi l'accesso al account di servizio sulla risorsa.

Accesso diretto alle risorse

Puoi concedere l'accesso a un'identità federata direttamente sulle risorse utilizzando la console Google Cloud o gcloud CLI.

Console

Per utilizzare la console Google Cloud per concedere i ruoli IAM direttamente su una risorsa, devi andare alla pagina della risorsa e poi concedere il ruolo. L'esempio seguente mostra come andare alla pagina Cloud Storage e concedere il ruolo Storage Object Viewer (roles/storage.objectViewer) a un'identità federata direttamente su un bucket Cloud Storage.

  1. Nella console Google Cloud , vai alla pagina Bucket in Cloud Storage.

    Vai a Bucket

  2. Nell'elenco dei bucket, fai clic sul nome del bucket per cui vuoi concedere il ruolo.

  3. Seleziona la scheda Autorizzazioni nella parte superiore della pagina.

  4. Fai clic sul pulsante Concedi l'accesso.

    Viene visualizzata la finestra di dialogo Aggiungi entità.

  5. Nel campo Nuove entità, inserisci una o più identità che devono accedere al tuo bucket.

    Per materia

    principal://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/subject/SUBJECT
    

    Sostituisci quanto segue:

    • PROJECT_NUMBER: il numero del progetto
    • POOL_ID: l'ID del pool di workload
    • SUBJECT: il singolo soggetto mappato dal tuo IdP, ad esempio administrator@example.com

    Per gruppo

    principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/group/GROUP
    

    Sostituisci quanto segue:

    • PROJECT_NUMBER: il numero del progetto
    • WORKLOAD_POOL_ID: l'ID del pool di workload
    • GROUP: il gruppo mappato dal tuo IdP, ad esempio administrator-group@example.com

    Per attributo

    principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/attribute.ATTRIBUTE_NAME/ATTRIBUTE_VALUE
    

    Sostituisci quanto segue:

    • PROJECT_NUMBER: il numero del progetto
    • WORKLOAD_POOL_ID: l'ID del pool di workload
    • ATTRIBUTE_NAME: uno degli attributi mappati dal tuo IdP
    • ATTRIBUTE_VALUE: il valore dell'attributo
  6. Seleziona uno o più ruoli dal menu a discesa Seleziona un ruolo. I ruoli selezionati vengono visualizzati nel riquadro con una breve descrizione delle autorizzazioni che concedono.

  7. Fai clic su Salva.

gcloud

Per utilizzare gcloud CLI per concedere ruoli IAM su una risorsa in un progetto, segui questi passaggi:

  1. Ottieni il numero del progetto in cui è definita la risorsa.

    gcloud projects describe $(gcloud config get-value core/project) --format=value\(projectNumber\)
    
  2. Concedi l'accesso alla risorsa.

    Per utilizzare gcloud CLI per concedere il ruolo Visualizzatore oggetti Storage (roles/storage.objectViewer) alle identità esterne che soddisfano determinati criteri, esegui questo comando.

    Per materia

    gcloud storage buckets add-iam-policy-binding BUCKET_ID \
        --role=roles/storage.objectViewer \
        --member="principal://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/subject/SUBJECT"

    Per gruppo

    gcloud storage buckets add-iam-policy-binding BUCKET_ID \
        --role=roles/storage.objectViewer \
        --member="principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/group/GROUP"

    Per attributo

    gcloud storage buckets add-iam-policy-binding BUCKET_ID \
        --role=roles/storage.objectViewer \
        --member="principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/attribute.ATTRIBUTE_NAME/ATTRIBUTE_VALUE"

    Sostituisci quanto segue:

    • BUCKET_ID: il bucket a cui concedere l'accesso
    • PROJECT_NUMBER: il numero di progetto del progetto che contiene il pool di identità del workload
    • POOL_ID: l'ID del pool di identità del workload
    • SUBJECT: il valore previsto per l'attributo che hai mappato a google.subject
    • GROUP: il valore previsto per l'attributo che hai mappato a google.groups
    • ATTRIBUTE_NAME: il nome di un attributo personalizzato nella mappatura degli attributi
    • ATTRIBUTE_VALUE: il valore dell'attributo personalizzato nella mappatura degli attributi

    Puoi concedere ruoli su qualsiasi risorsa Google Cloud che supporta le policy di autorizzazione IAM.

Simulazione dell'identità dei service account

  1. Per creare un account di servizio per il workload esterno, segui questi passaggi:

    1. Attiva le API IAM, Security Token Service e API Service Account Credentials, se non sono già attive.

      Ruoli richiesti per abilitare le API

      Per abilitare le API, devi disporre dell'autorizzazione serviceusage.services.enable. Se hai creato il progetto, probabilmente disponi già di questa autorizzazione tramite il ruolo Proprietario (roles/owner). In caso contrario, puoi ottenere questa autorizzazione tramite il ruolo Amministratore Service Usage (roles/serviceusage.serviceUsageAdmin). Scopri come concedere i ruoli.

      Abilita le API

    2. Crea un service account che rappresenta il workload. Ti consigliamo di utilizzare un account di servizio dedicato per ogni workload. Il account di servizio non deve trovarsi nello stesso progetto del pool di identità del workload, ma devi fare riferimento al progetto che contiene il account di servizio.

    3. Concedi al account di servizio l'accesso alle risorse a cui vuoi che accedano le identità esterne.

  2. Per consentire all'identità federata di impersonare il account di servizio, segui questi passaggi:

Console

Per utilizzare la console Google Cloud per concedere ruoli IAM a un'identità federata con un account di servizio, segui questi passaggi:

Service account nello stesso progetto

  1. Per concedere l'accesso utilizzando la simulazione dell'identità dei account di servizio per un account di servizio nello stesso progetto, segui questi passaggi:

    1. Vai alla pagina Pool di Workload Identity.

      Vai a Pool di identità del workload

    2. Seleziona Concedi l'accesso.

    3. Nella finestra di dialogo Concedi l'accesso al service account, seleziona Concedi l'accesso utilizzando la simulazione dell'identità dei service account.

    4. Nell'elenco Service account, seleziona il account di servizio di cui le identità esterne devono assumere l'identità e segui questi passaggi:

    5. Per scegliere quali identità nel pool possono impersonare il account di servizio, esegui una delle seguenti azioni:

      • Per consentire solo a identità specifiche del pool di identità del workload di simulare l'identità del account di servizio, seleziona Solo le identità corrispondenti al filtro.

      • Nell'elenco nome dell'attributo, seleziona l'attributo in base al quale vuoi filtrare.

      • Nel campo Valore attributo, inserisci il valore previsto dell'attributo. Ad esempio, se utilizzi una mappatura degli attributi google.subject=assertion.sub, imposta il nome dell'attributo su subject e il valore dell'attributo sul valore della rivendicazione sub nei token emessi dal tuo provider di identità esterno.

    6. Per salvare la configurazione, fai clic su Salva e poi su Ignora.

Service account in un progetto diverso

  1. Per concedere l'accesso utilizzando la simulazione dell'identità dei account di servizio per un account di servizio in un altro progetto, segui questi passaggi:

    1. Vai alla pagina Service Accounts.

      Vai a Service account

    2. Seleziona il account di servizio di cui vuoi assumere l'identità.

    3. Fai clic su Gestisci accesso.

    4. Fai clic su Aggiungi entità.

    5. Nel campo Nuova entità, inserisci uno dei seguenti identificatori di entità per le identità nel tuo pool che assumeranno l'identità del account di servizio.

      Per materia

      principal://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/subject/SUBJECT
      

      Sostituisci quanto segue:

      • PROJECT_NUMBER: il numero del progetto
      • POOL_ID: l'ID del pool di workload
      • SUBJECT: il singolo soggetto mappato dal tuo IdP, ad esempio administrator@example.com

      Per gruppo

      principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/group/GROUP
      

      Sostituisci quanto segue:

      • PROJECT_NUMBER: il numero del progetto
      • WORKLOAD_POOL_ID: l'ID del pool di workload
      • GROUP: il gruppo mappato dal tuo IdP, ad esempio administrator-group@example.com

      Per attributo

      principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/attribute.ATTRIBUTE_NAME/ATTRIBUTE_VALUE
      

      Sostituisci quanto segue:

      • PROJECT_NUMBER: il numero del progetto
      • WORKLOAD_POOL_ID: l'ID del pool di workload
      • ATTRIBUTE_NAME: uno degli attributi mappati dal tuo IdP
      • ATTRIBUTE_VALUE: il valore dell'attributo

      Per pool

      principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/*
      

      Sostituisci quanto segue:

      • PROJECT_NUMBER: il numero del progetto
      • WORKLOAD_POOL_ID: l'ID del pool di workload
    6. In Seleziona un ruolo, seleziona il ruolo Utente Workload Identity (roles/iam.workloadIdentityUser).

    7. Per salvare la configurazione, fai clic su Salva.

gcloud

Per concedere il ruolo Utente Workload Identity (roles/iam.workloadIdentityUser) a un'entità federata o a un set di entità, esegui il seguente comando. Per scoprire di più sugli identificatori delle entità della federazione delle identità per i workload, consulta Tipi di entità.

Per materia

gcloud iam service-accounts add-iam-policy-binding SERVICE_ACCOUNT_EMAIL \
    --role=roles/iam.workloadIdentityUser \
    --member="principal://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/subject/SUBJECT"

Per gruppo

gcloud iam service-accounts add-iam-policy-binding SERVICE_ACCOUNT_EMAIL \
    --role=roles/iam.workloadIdentityUser \
    --member="principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/group/GROUP"

Per attributo

gcloud iam service-accounts add-iam-policy-binding SERVICE_ACCOUNT_EMAIL \
    --role=roles/iam.workloadIdentityUser \
    --member="principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/attribute.ATTRIBUTE_NAME/ATTRIBUTE_VALUE"

Sostituisci quanto segue:

  • SERVICE_ACCOUNT_EMAIL: l'indirizzo email del account di servizio
  • PROJECT_NUMBER: il numero di progetto del progetto che contiene il pool di identità del workload
  • POOL_ID: l'ID del pool di identità del workload
  • SUBJECT: il valore previsto per l'attributo che hai mappato a google.subject
  • GROUP: il valore previsto per l'attributo che hai mappato a google.groups
  • ATTRIBUTE_NAME: il nome di un attributo personalizzato nella mappatura degli attributi
  • ATTRIBUTE_VALUE: il valore dell'attributo personalizzato nella mappatura degli attributi

Configura la pipeline di deployment

Questa sezione descrive come utilizzare la federazione delle identità per i workload nella pipeline di deployment. Le istruzioni in questa sezione presuppongono che i tuoi workload utilizzino la simulazione dell'identità dei service account per accedere alle risorse Google Cloud.

Azure DevOps

Modifica il file azure-pipelines.yml e aggiungi quanto segue alla configurazione del job:

variables:
- name: Azure.WorkloadIdentity.Connection
  value: CONNECTION
- name: GoogleCloud.WorkloadIdentity.ProjectNumber
  value: PROJECT_NUMBER
- name: GoogleCloud.WorkloadIdentity.Pool
  value: POOL_ID
- name: GoogleCloud.WorkloadIdentity.Provider
  value: PROVIDER_ID
- name: GoogleCloud.WorkloadIdentity.ServiceAccount
  value: SERVICE_ACCOUNT_EMAIL
- name: GOOGLE_APPLICATION_CREDENTIALS
  value: $(Pipeline.Workspace)/.workload_identity.wlconfig

steps:
  - task: AzureCLI@2
    inputs:
      connectedServiceNameARM: $(Azure.WorkloadIdentity.Connection)
      addSpnToEnvironment: true
      scriptType: 'bash'
      scriptLocation: 'inlineScript'
      inlineScript: |
        echo $idToken > $(Pipeline.Workspace)/.workload_identity.jwt
        cat << EOF > $GOOGLE_APPLICATION_CREDENTIALS
        {
          "type": "external_account",
          "audience": "//iam.googleapis.com/projects/$(GoogleCloud.WorkloadIdentity.ProjectNumber)/locations/global/workloadIdentityPools/$(GoogleCloud.WorkloadIdentity.Pool)/providers/$(GoogleCloud.WorkloadIdentity.Provider)",
          "subject_token_type": "urn:ietf:params:oauth:token-type:jwt",
          "token_url": "https://sts.REGION.rep.googleapis.com/v1/token",
          "credential_source": {
            "file": "$(Pipeline.Workspace)/.workload_identity.jwt"
          },
          "service_account_impersonation_url": "https://iamcredentials.googleapis.com/v1/projects/-/serviceAccounts/$(GoogleCloud.WorkloadIdentity.ServiceAccount):generateAccessToken"
        }
        EOF

  - task: Bash@3
    displayName: 'Verify Google Cloud authentication'
    inputs:
      targetType: 'inline'
      script: |
        gcloud auth login --cred-file="$(GOOGLE_APPLICATION_CREDENTIALS)"
        gcloud auth print-access-token

Sostituisci i seguenti valori:

  • CONNECTION: il nome della connessione di servizio.
  • PROJECT_NUMBER: il numero del progetto che contiene il pool di identità del workload.
  • POOL_ID: l'ID del pool di identità del workload.
  • PROVIDER_ID: l'ID del provider del pool di identità del workload.
  • SERVICE_ACCOUNT_EMAIL: l'indirizzo email del account di servizio, se utilizzi la simulazione dell'identità dei account di servizio. Se utilizzi l'accesso diretto alle risorse, ometti GoogleCloud.WorkloadIdentity.ServiceAccount e service_account_impersonation_url.
  • REGION: una regione per gli endpoint STS regionali, se disponibili. Se gli endpoint regionali non sono disponibili, puoi utilizzare https://sts.googleapis.com/v1/token.

La configurazione esegue le seguenti operazioni:

  1. Utilizza l'attività AzureCLI per ottenere un token ID per la connessione di servizio e lo rende disponibile in una variabile denominata idToken.
  2. Salva il token ID in un file temporaneo denominato .workload_identity.jwt.
  3. Crea un file di configurazione delle credenziali che indica alle librerie client di leggere il token ID da .workload_identity.jwt e lo utilizza per simulare l'identità di un account di servizio.
  4. Imposta la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS in modo che punti al file di configurazione delle credenziali.
  5. Verifica la configurazione autenticandosi su Google Cloud e stampando un token di accesso.

GitHub Actions

L'azione google-github-actions/auth consente di generare automaticamente un file di configurazione delle credenziali durante l'esecuzione del workflow. Le librerie client e gli strumenti come terraform possono quindi utilizzare questo file di configurazione delle credenziali per ottenere automaticamente le credenziali di Google.

Modifica il file YAML di GitHub Actions e aggiungi quanto segue:

  • Consenti al job di recuperare un token ID GitHub aggiungendo la seguente configurazione:

    permissions:
      id-token: write
      contents: read
    
  • Aggiungi un passaggio per creare un file di configurazione delle credenziali:

    - id: 'auth'
      name: 'Authenticate to Google Cloud'
      uses: 'google-github-actions/auth@v1'
      with:
        create_credentials_file: true
        workload_identity_provider: 'projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID'
        service_account: 'SERVICE_ACCOUNT_EMAIL'
    

Sostituisci quanto segue:

  • PROJECT_NUMBER: il numero del progetto che contiene il pool di identità del workload.
  • POOL_ID: l'ID del pool di identità del workload.
  • PROVIDER_ID: l'ID del provider del pool di identità del workload.
  • SERVICE_ACCOUNT_EMAIL: l'indirizzo email del account di servizio, se utilizzi la simulazione dell'identità dei account di servizio. Se utilizzi l'accesso diretto alle risorse, ometti service_account.

L'esempio seguente configura l'azione GitHub:

jobs:
  build:
    # Allow the job to fetch a GitHub ID token
    permissions:
      id-token: write
      contents: read

    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v3

      - id: 'auth'
        name: 'Authenticate to Google Cloud'
        uses: 'google-github-actions/auth@v1'
        with:
          create_credentials_file: true
          workload_identity_provider: 'projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID'
          service_account: 'SERVICE_ACCOUNT_EMAIL'

Per ulteriori dettagli sull'utilizzo dell'azione google-github-actions/auth, consulta Configurazione della federazione delle identità per i workload.

GitLab SaaS

Modifica il file .gitlab-ci.yml e aggiungi quanto segue alla configurazione del job:

job:
  variables:
    WORKLOAD_IDENTITY_PROJECT_NUMBER: PROJECT_NUMBER
    WORKLOAD_IDENTITY_POOL: POOL_ID
    WORKLOAD_IDENTITY_PROVIDER: PROVIDER_ID
    SERVICE_ACCOUNT: SERVICE_ACCOUNT_EMAIL
    GOOGLE_APPLICATION_CREDENTIALS: $CI_BUILDS_DIR/.workload_identity.wlconfig

  id_tokens:
    WORKLOAD_IDENTITY_TOKEN:
      aud: https://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID

  script:
    - |-
      echo $WORKLOAD_IDENTITY_TOKEN > $CI_BUILDS_DIR/.workload_identity.jwt
      cat << EOF > $GOOGLE_APPLICATION_CREDENTIALS
      {
        "type": "external_account",
        "audience": "//iam.googleapis.com/projects/$WORKLOAD_IDENTITY_PROJECT_NUMBER/locations/global/workloadIdentityPools/$WORKLOAD_IDENTITY_POOL/providers/$WORKLOAD_IDENTITY_PROVIDER",
        "subject_token_type": "urn:ietf:params:oauth:token-type:jwt",
        "token_url": "https://sts.REGION.rep.googleapis.com/v1/token",
        "credential_source": {
          "file": "$CI_BUILDS_DIR/.workload_identity.jwt"
        },
        "service_account_impersonation_url": "https://iamcredentials.googleapis.com/v1/projects/-/serviceAccounts/$SERVICE_ACCOUNT:generateAccessToken"
      }
      EOF

Sostituisci i seguenti valori:

  • PROJECT_NUMBER: il numero del progetto che contiene il pool di identità del workload.
  • POOL_ID: l'ID del pool di identità del workload.
  • PROVIDER_ID: l'ID del provider del pool di identità del workload.
  • SERVICE_ACCOUNT_EMAIL: l'indirizzo email del account di servizio, se utilizzi la simulazione dell'identità dei account di servizio. Se utilizzi l'accesso diretto alle risorse, ometti SERVICE_ACCOUNT e service_account_impersonation_url.
  • REGION: una regione per gli endpoint STS regionali, se disponibili. Se gli endpoint regionali non sono disponibili, puoi utilizzare https://sts.googleapis.com/v1/token.

La configurazione esegue le seguenti operazioni:

  1. Indica a GitLab di emettere un token ID e lo rende disponibile nella variabile di ambiente denominata WORKLOAD_IDENTITY_TOKEN. Il token ID utilizza il provider di pool di identità del workload come audience.
  2. Salva il token ID in un file temporaneo denominato .workload_identity.jwt.
  3. Crea un file di configurazione delle credenziali che indica alle librerie client di leggere il token ID da .workload_identity.jwt e lo utilizza per simulare l'identità di un account di servizio.
  4. Imposta la variabile di ambiente GOOGLE_APPLICATION_CREDENTIALS in modo che punti al file di configurazione delle credenziali.

HCP Terraform

Configura l'area di lavoro HCP Terraform in modo che utilizzi la federazione delle identità per i workload per l'autenticazione in Google Cloud utilizzando la simulazione dell'identità dei account di servizio:

  1. In HCP Terraform, apri l'area di lavoro e vai a Variabili.

  2. Aggiungi le seguenti variabili:

    Categoria di variabile Chiave Valore
    Variabile di ambiente TFC_GCP_PROVIDER_AUTH true
    Variabile di ambiente TFC_GCP_RUN_SERVICE_ACCOUNT_EMAIL L'indirizzo email del account di servizio, se utilizzi la simulazione dell'identità dei service account, ad esempio terraform@my-project-123.iam.gserviceaccount.com.
    Variabile di ambiente TFC_GCP_PROJECT_NUMBER Il numero di progetto del progetto contenente il pool di identità del workload
    Variabile di ambiente TFC_GCP_WORKLOAD_POOL_ID L'ID del pool di identità del workload
    Variabile di ambiente TFC_GCP_WORKLOAD_PROVIDER_ID L'ID del provider di pool di identità del workload

    Facoltativamente, puoi aggiungere altre variabili di ambiente per consentire a HCP Terraform di utilizzare service account diversi per le fasi plan e apply. Per saperne di più sull'utilizzo delle variabili di ambiente nelle configurazioni Terraform, consulta Variabili di ambiente facoltative.

  3. Nell'elenco delle variabili, verifica che Categoria sia impostata su env per le cinque variabili aggiunte nel passaggio precedente.

  4. Verifica che la configurazione di Terraform utilizzi la versione 4.48.0 o una versione successiva del provider Google Cloud e aggiornala, se necessario, come segue:

    terraform {
      required_providers {
        google = {
          source  = "hashicorp/google"
          version = "~> 4.48.0"
        }
      }
    }
    
  5. Invia le modifiche al repository di codice sorgente.

Passaggi successivi