Gestione dei provider e dei pool di identità per i carichi di lavoro

La federazione delle identità per i workload ti consente di concedere ai workload esterni l'accesso alle risorseGoogle Cloud tramite ipool di identità dei workloade i provider di identità (IdP) connessi. Man mano che i tuoi requisiti cambiano, puoi creare, visualizzare, aggiornare, eliminare o annullare l'eliminazione di pool e provider utilizzando la consoleGoogle Cloud , Google Cloud CLI o l'API REST.

Prima di iniziare

Crea un pool di identità del workload. Per istruzioni, consulta le guide alla configurazione della federazione delle identità per i workload.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per gestire i pool di identità del workload e i provider, chiedi all'amministratore di concederti i seguenti ruoli IAM sul progetto:

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questi ruoli predefiniti contengono le autorizzazioni necessarie per gestire i pool di identità del workload e i provider. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per gestire i pool e i provider di identità dei workload sono necessarie le seguenti autorizzazioni:

  • Per visualizzare i pool di identità del workload e i provider:
    • iam.googleapis.com/workloadIdentityPoolProviders.get
    • iam.googleapis.com/workloadIdentityPoolProviders.list
    • iam.googleapis.com/workloadIdentityPools.get
    • iam.googleapis.com/workloadIdentityPools.list
  • Per creare, aggiornare ed eliminare pool e provider:
    • iam.googleapis.com/workloadIdentityPoolProviders.create
    • iam.googleapis.com/workloadIdentityPoolProviders.delete
    • iam.googleapis.com/workloadIdentityPoolProviders.undelete
    • iam.googleapis.com/workloadIdentityPoolProviders.update
    • iam.googleapis.com/workloadIdentityPools.create
    • iam.googleapis.com/workloadIdentityPools.delete
    • iam.googleapis.com/workloadIdentityPools.undelete
    • iam.googleapis.com/workloadIdentityPools.update

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Gestisci i pool di identità del workload

Questa sezione mostra come gestire i pool di identità dei workload.

Crea pool

Per creare pool di identità del workload in un progetto, segui questi passaggi:

Console

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

    Vai a Nuovo provider e pool di workload

  2. Nella sezione Crea un pool di identità, inserisci un nome per il pool.

    La console Google Cloud utilizza il nome per creare un ID pool. Per modificare l'ID pool, fai clic su Modifica. Non potrai modificare l'ID pool in un secondo momento.

  3. (Facoltativo) Nel campo Descrizione, inserisci una descrizione del pool.
  4. (Facoltativo) Per creare il pool in uno stato disattivato, fai clic sul pulsante di attivazione/disattivazione Pool abilitato.
  5. Fai clic su Continua.
  6. Nelle sezioni Aggiungi un provider al pool e Configura attributi del provider, configura un provider di identità per il pool. Per le istruzioni, consulta Crea un provider.
  7. Fai clic su Salva.

gcloud

Il comando gcloud iam workload-identity-pools create crea un pool di identità del workload in un progetto.

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • POOL_ID: un ID univoco per il pool di identità del workload, ad esempio my-pool. Deve contenere da 4 a 32 caratteri alfanumerici minuscoli o trattini e non può iniziare con gcp-.
  • PROJECT_ID: l'ID progetto Google Cloud . Gli ID progetto sono stringhe alfanumeriche, come my-project.
  • DISPLAY_NAME: (Facoltativo) Un nome visualizzato per il pool di identità del workload, composto da un massimo di 32 caratteri, ad esempio My workload pool.
  • DESCRIPTION: (Facoltativo) Una descrizione del pool di identità del workload, fino a 256 caratteri.

Esegui questo comando:

Linux, macOS o Cloud Shell

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

Windows (PowerShell)

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

Windows (cmd.exe)

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

Dovresti ricevere una risposta simile alla seguente:

Create request issued for: [my-pool]
Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000000-0123456789abcdef] to complete...done.
Created workloadIdentityPool [my-pool].

REST

Il metodo projects.locations.workloadIdentityPools.create crea un pool di identità del workload in un progetto.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • PROJECT_ID: l'ID progetto Google Cloud . Gli ID progetto sono stringhe alfanumeriche, come my-project.
  • POOL_ID: un ID univoco per il pool di identità del workload, ad esempio my-pool. Deve contenere da 4 a 32 caratteri alfanumerici minuscoli o trattini e non può iniziare con gcp-.
  • DISPLAY_NAME: (Facoltativo) Un nome visualizzato per il pool di identità del workload, composto da un massimo di 32 caratteri, ad esempio My workload pool.
  • DESCRIPTION: (Facoltativo) Una descrizione del pool di identità del workload, fino a 256 caratteri.

Metodo HTTP e URL:

POST https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools?workloadIdentityPoolId=POOL_ID

Corpo JSON della richiesta:

{
  "displayName": "DISPLAY_NAME",
  "description": "DESCRIPTION"
}

Per inviare la richiesta, espandi una di queste opzioni:

La risposta contiene un'operazione a lunga esecuzione che rappresenta la tua richiesta. Per verificare se la creazione del pool è stata completata, consulta Controlla lo stato di un'operazione a lunga esecuzione in questa pagina.

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000000-0123456789abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolOperationMetadata"
  },
  "done": false
}

Elenca i pool

Per elencare tutti i pool di identità del workload in un progetto, segui questi passaggi:

Console

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

    Vai a Pool di identità del workload

  2. Nella tabella, visualizza l'elenco dei pool di identità del workload.
  3. (Facoltativo) Per includere nell'elenco i pool e i provider eliminati, fai clic sul pulsante di attivazione/disattivazione Mostra i pool e i provider eliminati.

gcloud

Il comando gcloud iam workload-identity-pools list elenca i pool di identità del workload in un progetto.

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • PROJECT_ID: l'ID progetto Google Cloud . Gli ID progetto sono stringhe alfanumeriche, come my-project. Per includere i pool eliminati temporaneamente nell'output, aggiungi il flag --show-deleted.

Esegui questo comando:

Linux, macOS o Cloud Shell

gcloud iam workload-identity-pools list \
    --project=PROJECT_ID \
    --location="global" \
    --format="json"

Windows (PowerShell)

gcloud iam workload-identity-pools list `
    --project=PROJECT_ID `
    --location="global" `
    --format="json"

Windows (cmd.exe)

gcloud iam workload-identity-pools list ^
    --project=PROJECT_ID ^
    --location="global" ^
    --format="json"

Dovresti ricevere una risposta simile alla seguente:

[
  {
    "description": "Workload identity pool for external workloads.",
    "displayName": "My workload pool",
    "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool",
    "state": "ACTIVE"
  }
]

REST

Il metodo projects.locations.workloadIdentityPools.list elenca i pool di identità del workload in un progetto.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • PROJECT_ID: l'ID progetto Google Cloud . Gli ID progetto sono stringhe alfanumeriche, come my-project. Per includere i pool eliminati temporaneamente nella risposta, aggiungi ?showDeleted=true all'URL della richiesta.

Metodo HTTP e URL:

GET https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "workloadIdentityPools": [
    {
      "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool",
      "displayName": "My workload pool",
      "description": "Workload identity pool for external workloads.",
      "state": "ACTIVE"
    }
  ]
}

Ottieni un pool

Per visualizzare i dettagli di un pool di identità del workload specifico, segui questi passaggi:

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 vuoi visualizzare, quindi fai clic sul suo nome visualizzato. La console Google Cloud mostra i dettagli del pool di identità del workload.

gcloud

Il comando gcloud iam workload-identity-pools describe recupera i dettagli di un pool di identità del workload.

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • POOL_ID: l'ID del pool di identità del workload, ad esempio my-pool.
  • PROJECT_ID: l'ID progetto Google Cloud . Gli ID progetto sono stringhe alfanumeriche, come my-project.

Esegui questo comando:

Linux, macOS o Cloud Shell

gcloud iam workload-identity-pools describe POOL_ID \
    --project=PROJECT_ID \
    --location="global" \
    --format="json"

Windows (PowerShell)

gcloud iam workload-identity-pools describe POOL_ID `
    --project=PROJECT_ID `
    --location="global" `
    --format="json"

Windows (cmd.exe)

gcloud iam workload-identity-pools describe POOL_ID ^
    --project=PROJECT_ID ^
    --location="global" ^
    --format="json"

Dovresti ricevere una risposta simile alla seguente:

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool",
  "displayName": "My workload pool",
  "description": "Workload identity pool for external workloads.",
  "state": "ACTIVE"
}

REST

Il metodo projects.locations.workloadIdentityPools.get recupera i dettagli di un pool di identità del workload.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • PROJECT_ID: l'ID progetto Google Cloud . Gli ID progetto sono stringhe alfanumeriche, come my-project.
  • POOL_ID: l'ID del pool di identità del workload, ad esempio my-pool.

Metodo HTTP e URL:

GET https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool",
  "displayName": "My workload pool",
  "description": "Workload identity pool for external workloads.",
  "state": "ACTIVE"
}

Aggiorna un pool

Puoi attivare o disattivare un pool di identità del workload. Puoi anche modificarne il nome visualizzato o la descrizione.

Per aggiornare un pool di identità del workload esistente, segui questi passaggi:

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 vuoi modificare.
  3. Fai clic sul nome visualizzato del pool di identità del workload.
  4. Per modificare il nome visualizzato del pool di identità del workload, segui questi passaggi:

    1. Nella pagina Dettagli pool, accanto al nome visualizzato, fai clic sull'icona Modifica.
    2. Nella finestra di dialogo Modifica il nome visualizzato del pool che viene visualizzata, aggiorna il nome visualizzato.
    3. Fai clic su Salva.
  5. Per disattivare o attivare il pool di identità del workload, fai clic sul pulsante di attivazione/disattivazione Stato, quindi su Disattiva o Attiva.
  6. Per modificare la descrizione:

    1. In Descrizione, accanto al testo della descrizione, fai clic su Modifica.
    2. Aggiorna la descrizione.
    3. Fai clic su Salva.

gcloud

Il comando gcloud iam workload-identity-pools update aggiorna un pool di identità del workload esistente.

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • POOL_ID: l'ID del pool di identità del workload, ad esempio my-pool.
  • PROJECT_ID: l'ID progetto Google Cloud . Gli ID progetto sono stringhe alfanumeriche, come my-project.
  • DISPLAY_NAME: un nome visualizzato per il pool di identità del workload, fino a 32 caratteri, ad esempio My updated pool.
  • DESCRIPTION: una descrizione del pool di identità del workload, fino a 256 caratteri. Per disattivare o attivare il pool, passa anche il flag --disabled o --no-disabled.

Esegui questo comando:

Linux, macOS o Cloud Shell

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

Windows (PowerShell)

gcloud iam workload-identity-pools update POOL_ID `
    --project=PROJECT_ID `
    --location="global" `
    --display-name="DISPLAY_NAME" `
    --description="DESCRIPTION"

Windows (cmd.exe)

gcloud iam workload-identity-pools update POOL_ID ^
    --project=PROJECT_ID ^
    --location="global" ^
    --display-name="DISPLAY_NAME" ^
    --description="DESCRIPTION"

Dovresti ricevere una risposta simile alla seguente:

Update request issued for: [my-pool]
Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000001-0123456789abcdef] to complete...done.
Updated workloadIdentityPool [my-pool].

REST

Il metodo projects.locations.workloadIdentityPools.patch aggiorna un pool di identità del workload esistente.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • PROJECT_ID: l'ID progetto Google Cloud . Gli ID progetto sono stringhe alfanumeriche, come my-project.
  • POOL_ID: l'ID del pool di identità del workload, ad esempio my-pool.
  • UPDATE_MASK: un elenco separato da virgole di campi da aggiornare, ad esempio displayName,description,disabled.
  • DISPLAY_NAME: un nome visualizzato per il pool di identità del workload, fino a 32 caratteri, ad esempio My updated pool.
  • DESCRIPTION: una descrizione del pool di identità del workload, fino a 256 caratteri.
  • DISABLED: indica se il pool è disattivato. Imposta su true per disattivare il pool o su false per attivarlo.

Metodo HTTP e URL:

PATCH https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID?updateMask=UPDATE_MASK

Corpo JSON della richiesta:

{
  "displayName": "DISPLAY_NAME",
  "description": "DESCRIPTION",
  "disabled": DISABLED
}

Per inviare la richiesta, espandi una di queste opzioni:

La risposta contiene un'operazione a lunga esecuzione che rappresenta la tua richiesta. Per verificare se l'aggiornamento del pool è stato completato, consulta Controlla lo stato di un'operazione a lunga esecuzione in questa pagina.

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000001-0123456789abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolOperationMetadata"
  },
  "done": false
}

Elimina un pool

Quando elimini un pool di identità del workload, elimini anche i relativi provider di pool di identità del workload. Di conseguenza, le identità nel pool perdono l'accesso alle risorseGoogle Cloud .

Puoi annullare l'eliminazione di un pool per un massimo di 30 giorni dopo l'eliminazione. Dopo 30 giorni, l'eliminazione è definitiva. Fino a quando un pool non viene eliminato definitivamente, non puoi riutilizzarne il nome durante la creazione di un nuovo pool di identità del workload.

Per eliminare un pool di identità del workload e i relativi IdP, segui questi passaggi:

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 vuoi eliminare, quindi fai clic sul suo nome visualizzato.
  3. Fai clic su Elimina pool, quindi su Elimina. Il pool di identità del workload e i relativi IdP vengono eliminati.

gcloud

Il comando gcloud iam workload-identity-pools delete elimina un pool di identità del workload.

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • POOL_ID: l'ID del pool di identità del workload da eliminare, ad esempio my-pool.
  • PROJECT_ID: l'ID progetto Google Cloud . Gli ID progetto sono stringhe alfanumeriche, come my-project.

Esegui questo comando:

Linux, macOS o Cloud Shell

gcloud iam workload-identity-pools delete POOL_ID \
    --project=PROJECT_ID \
    --location="global"

Windows (PowerShell)

gcloud iam workload-identity-pools delete POOL_ID `
    --project=PROJECT_ID `
    --location="global"

Windows (cmd.exe)

gcloud iam workload-identity-pools delete POOL_ID ^
    --project=PROJECT_ID ^
    --location="global"

Dovresti ricevere una risposta simile alla seguente:

Delete request issued for: [my-pool]
Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000002-0123456789abcdef] to complete...done.
Deleted workloadIdentityPool [my-pool].

REST

Il metodo projects.locations.workloadIdentityPools.delete elimina un pool di identità del workload.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • PROJECT_ID: l'ID progetto Google Cloud . Gli ID progetto sono stringhe alfanumeriche, come my-project.
  • POOL_ID: l'ID del pool di identità del workload da eliminare, ad esempio my-pool.

Metodo HTTP e URL:

DELETE https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID

Per inviare la richiesta, espandi una di queste opzioni:

La risposta contiene un'operazione a lunga esecuzione che rappresenta la tua richiesta. Per verificare se l'eliminazione del pool è stata completata, consulta Controlla lo stato di un'operazione a lunga esecuzione in questa pagina.

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000002-0123456789abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolOperationMetadata"
  },
  "done": false
}

Annulla l'eliminazione di un pool

Puoi recuperare un pool di identità del workload eliminato fino a 30 giorni dopo l'eliminazione.

Per annullare l'eliminazione di un pool, segui questi passaggi:

Console

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

    Vai a Pool di identità del workload

  2. Fai clic sul pulsante di attivazione/disattivazione Mostra i pool e i provider eliminati.
  3. Trova il pool di identità del workload che vuoi annullare l'eliminazione, quindi fai clic sulla relativa icona Ripristina.
  4. Fai clic su Ripristina. Il pool e i relativi provider vengono ripristinati.

gcloud

Il comando gcloud iam workload-identity-pools undelete ripristina un pool di identità del workload eliminato temporaneamente.

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • POOL_ID: l'ID del pool di identità del workload eliminato da ripristinare, ad esempio my-pool.
  • PROJECT_ID: l'ID progetto Google Cloud . Gli ID progetto sono stringhe alfanumeriche, come my-project.

Esegui questo comando:

Linux, macOS o Cloud Shell

gcloud iam workload-identity-pools undelete POOL_ID \
    --project=PROJECT_ID \
    --location="global"

Windows (PowerShell)

gcloud iam workload-identity-pools undelete POOL_ID `
    --project=PROJECT_ID `
    --location="global"

Windows (cmd.exe)

gcloud iam workload-identity-pools undelete POOL_ID ^
    --project=PROJECT_ID ^
    --location="global"

Dovresti ricevere una risposta simile alla seguente:

Undelete request issued for: [my-pool]
Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000003-0123456789abcdef] to complete...done.
Undeleted workloadIdentityPool [my-pool].

REST

Il metodo projects.locations.workloadIdentityPools.undelete ripristina un pool di identità del workload eliminato temporaneamente.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • PROJECT_ID: l'ID progetto Google Cloud . Gli ID progetto sono stringhe alfanumeriche, come my-project.
  • POOL_ID: l'ID del pool di identità del workload eliminato da ripristinare, ad esempio my-pool.

Metodo HTTP e URL:

POST https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID:undelete

Corpo JSON della richiesta:

{}

Per inviare la richiesta, espandi una di queste opzioni:

La risposta contiene un'operazione a lunga esecuzione che rappresenta la tua richiesta. Per verificare se il ripristino del pool è stato completato, consulta Controlla lo stato di un'operazione a lunga esecuzione in questa pagina.

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000003-0123456789abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolOperationMetadata"
  },
  "done": false
}

Gestisci i provider di pool di identità del workload

Questa sezione mostra come gestire i provider di pool di identità del workload.

Crea un provider

Per creare un provider di pool di identità del workload in un pool di identità del workload esistente, segui questi passaggi:

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 a cui vuoi aggiungere un provider, quindi fai clic sul relativo Nome visualizzato.
  3. Fai clic su Aggiungi provider.
  4. Seleziona il tipo di provider da creare:

    • AWS: un IdP Amazon Web Services (AWS).
    • OpenID Connect (OIDC): un IdP compatibile con OIDC. Sono inclusi Microsoft Azure.
  5. Inserisci un nome per il provider.

    La console Google Cloud utilizza il nome per creare un ID provider. Per modificare l'ID provider, fai clic su Modifica. Non potrai modificare l'ID provider in un secondo momento.

  6. Completa i campi rimanenti per il tuo provider:

    • AWS: inserisci l'ID account AWS.
    • OIDC: inserisci l'URL dell'emittente. Per Azure, l'URL dell'emittente utilizza il formato https://sts.windows.net/AZURE_TENANT_ID. Per altri provider, consulta la relativa documentazione.

    Al termine, fai clic su Continua.

  7. Per configurare la mappatura degli attributi, fai clic su Modifica mappatura. La mappatura degli attributi consente di utilizzare le informazioni sulle identità esterne per concedere l'accesso a un sottoinsieme di queste identità.

  8. (Facoltativo) Per fornire una condizione dell'attributo, che specifica le identità che possono eseguire l'autenticazione, fai clic su Aggiungi condizione e inserisci un'espressione CEL (Common Expression Language) valida. Per maggiori dettagli, consulta Condizioni degli attributi.
  9. Fai clic su Salva. Il provider di pool di identità del workload è stato creato.

gcloud

Crea un provider AWS

Il comando gcloud iam workload-identity-pools providers create-aws crea un provider del pool di identità del workload AWS.

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • PROVIDER_ID: un ID univoco per il provider, ad esempio my-aws-provider. Deve contenere da 4 a 32 caratteri alfanumerici minuscoli o trattini e non può iniziare con gcp-.
  • PROJECT_ID: l'ID progetto Google Cloud . Gli ID progetto sono stringhe alfanumeriche, come my-project.
  • POOL_ID: l'ID del pool di identità del workload a cui aggiungere il provider, ad esempio my-pool.
  • DISPLAY_NAME: (Facoltativo) Un nome visualizzato per il provider, fino a 32 caratteri, ad esempio My AWS provider.
  • AWS_ACCOUNT_ID: il tuo ID account AWS di 12 cifre, ad esempio 123456789012.
  • ATTRIBUTE_CONDITION: (Facoltativo) Un'espressione Common Expression Language (CEL) che limita le identità che possono autenticarsi, ad esempio attribute.aws_role == 'arn:aws:sts::123456789012:assumed-role/my-role'.

Esegui questo comando:

Linux, macOS o Cloud Shell

gcloud iam workload-identity-pools providers create-aws PROVIDER_ID \
    --project=PROJECT_ID \
    --location="global" \
    --workload-identity-pool="POOL_ID" \
    --display-name="DISPLAY_NAME" \
    --account-id="AWS_ACCOUNT_ID" \
    --attribute-condition="ATTRIBUTE_CONDITION"

Windows (PowerShell)

gcloud iam workload-identity-pools providers create-aws PROVIDER_ID `
    --project=PROJECT_ID `
    --location="global" `
    --workload-identity-pool="POOL_ID" `
    --display-name="DISPLAY_NAME" `
    --account-id="AWS_ACCOUNT_ID" `
    --attribute-condition="ATTRIBUTE_CONDITION"

Windows (cmd.exe)

gcloud iam workload-identity-pools providers create-aws PROVIDER_ID ^
    --project=PROJECT_ID ^
    --location="global" ^
    --workload-identity-pool="POOL_ID" ^
    --display-name="DISPLAY_NAME" ^
    --account-id="AWS_ACCOUNT_ID" ^
    --attribute-condition="ATTRIBUTE_CONDITION"

Dovresti ricevere una risposta simile alla seguente:

Create request issued for: [my-aws-provider]
Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-aws-provider/operations/operation-1700000000010-0123456789abcdef] to complete...done.
Created workloadIdentityPoolProvider [my-aws-provider].

Crea un provider OIDC

Il comando gcloud iam workload-identity-pools providers create-oidc crea un provider di pool di identità del workload OIDC.

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • PROVIDER_ID: un ID univoco per il provider, ad esempio my-oidc-provider. Deve contenere da 4 a 32 caratteri alfanumerici minuscoli o trattini e non può iniziare con gcp-.
  • PROJECT_ID: l'ID progetto Google Cloud . Gli ID progetto sono stringhe alfanumeriche, come my-project.
  • POOL_ID: l'ID del pool di identità del workload a cui aggiungere il provider, ad esempio my-pool.
  • DISPLAY_NAME: (Facoltativo) Un nome visualizzato per il provider, fino a 32 caratteri, ad esempio My OIDC provider.
  • ISSUER_URI: l'URL HTTPS dell'emittente OIDC, ad esempio https://idp.example.com o https://sts.windows.net/AZURE_TENANT_ID.
  • DISCOVERY_URI: facoltativo. L'URL da cui recuperare il documento di rilevamento OIDC, che sostituisce l'URL ISSUER_URI/.well-known/openid-configuration predefinito, ad esempio https://idp.example.com/.well-known/custom-openid-configuration. Lo schema, l'host e la porta devono corrispondere a ISSUER_URI e il percorso deve contenere un segmento /.well-known/ seguito da un suffisso non vuoto.
  • ATTRIBUTE_CONDITION: (Facoltativo) Un'espressione Common Expression Language (CEL) che limita le identità che possono autenticarsi, ad esempio assertion.sub.startsWith('repo:my-org/').
  • ACTOR_PROVIDERS: facoltativo. I nomi completi delle risorse di un massimo di tre provider di pool di identità del workload nello stesso pool autorizzati a emettere token attore per questo provider, ad esempio projects/my-project/locations/global/workloadIdentityPools/my-pool/providers/my-actor-provider. L'identificatore del progetto in ogni nome della risorsa deve corrispondere al formato dell'ID progetto o del numero di progetto che utilizzi per questo provider. Per saperne di più, consulta Configura la delega dell'identità e i token degli attori.

Esegui questo comando:

Linux, macOS o Cloud Shell

gcloud iam workload-identity-pools providers create-oidc PROVIDER_ID \
    --project=PROJECT_ID \
    --location="global" \
    --workload-identity-pool="POOL_ID" \
    --display-name="DISPLAY_NAME" \
    --issuer-uri="ISSUER_URI" \
    --discovery-uri="DISCOVERY_URI" \
    --attribute-mapping="google.subject=assertion.sub" \
    --attribute-condition="ATTRIBUTE_CONDITION" \
    --actor-providers="ACTOR_PROVIDERS"

Windows (PowerShell)

gcloud iam workload-identity-pools providers create-oidc PROVIDER_ID `
    --project=PROJECT_ID `
    --location="global" `
    --workload-identity-pool="POOL_ID" `
    --display-name="DISPLAY_NAME" `
    --issuer-uri="ISSUER_URI" `
    --discovery-uri="DISCOVERY_URI" `
    --attribute-mapping="google.subject=assertion.sub" `
    --attribute-condition="ATTRIBUTE_CONDITION" `
    --actor-providers="ACTOR_PROVIDERS"

Windows (cmd.exe)

gcloud iam workload-identity-pools providers create-oidc PROVIDER_ID ^
    --project=PROJECT_ID ^
    --location="global" ^
    --workload-identity-pool="POOL_ID" ^
    --display-name="DISPLAY_NAME" ^
    --issuer-uri="ISSUER_URI" ^
    --discovery-uri="DISCOVERY_URI" ^
    --attribute-mapping="google.subject=assertion.sub" ^
    --attribute-condition="ATTRIBUTE_CONDITION" ^
    --actor-providers="ACTOR_PROVIDERS"

Dovresti ricevere una risposta simile alla seguente:

Create request issued for: [my-oidc-provider]
Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider/operations/operation-1700000000011-0123456789abcdef] to complete...done.
Created workloadIdentityPoolProvider [my-oidc-provider].

REST

Crea un provider AWS

Il metodo projects.locations.workloadIdentityPools.providers.create crea un provider di pool di identità del workload AWS.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • PROJECT_ID: l'ID progetto Google Cloud . Gli ID progetto sono stringhe alfanumeriche, come my-project.
  • POOL_ID: l'ID del pool di identità del workload a cui aggiungere il provider, ad esempio my-pool.
  • PROVIDER_ID: un ID univoco per il provider, ad esempio my-aws-provider. Deve contenere da 4 a 32 caratteri alfanumerici minuscoli o trattini e non può iniziare con gcp-.
  • DISPLAY_NAME: (Facoltativo) Un nome visualizzato per il provider, fino a 32 caratteri, ad esempio My AWS provider.
  • AWS_ACCOUNT_ID: il tuo ID account AWS di 12 cifre, ad esempio 123456789012.
  • ATTRIBUTE_CONDITION: (Facoltativo) Un'espressione Common Expression Language (CEL) che limita le identità che possono autenticarsi, ad esempio attribute.aws_role == 'arn:aws:sts::123456789012:assumed-role/my-role'.

Metodo HTTP e URL:

POST https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID/providers?workloadIdentityPoolProviderId=PROVIDER_ID

Corpo JSON della richiesta:

{
  "displayName": "DISPLAY_NAME",
  "aws": {
    "accountId": "AWS_ACCOUNT_ID"
  },
  "attributeCondition": "ATTRIBUTE_CONDITION"
}

Per inviare la richiesta, espandi una di queste opzioni:

La risposta contiene un'operazione a lunga esecuzione che rappresenta la tua richiesta. Per verificare se la creazione del provider è stata completata, consulta Controlla lo stato di un'operazione a lunga esecuzione in questa pagina.

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-aws-provider/operations/operation-1700000000010-0123456789abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolProviderOperationMetadata"
  },
  "done": false
}

Crea un provider OIDC

Il metodo projects.locations.workloadIdentityPools.providers.create crea un provider di pool di identità del workload OIDC.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • PROJECT_ID: l'ID progetto Google Cloud . Gli ID progetto sono stringhe alfanumeriche, come my-project.
  • POOL_ID: l'ID del pool di identità del workload a cui aggiungere il provider, ad esempio my-pool.
  • PROVIDER_ID: un ID univoco per il provider, ad esempio my-oidc-provider. Deve contenere da 4 a 32 caratteri alfanumerici minuscoli o trattini e non può iniziare con gcp-.
  • DISPLAY_NAME: (Facoltativo) Un nome visualizzato per il provider, fino a 32 caratteri, ad esempio My OIDC provider.
  • ISSUER_URI: l'URL HTTPS dell'emittente OIDC, ad esempio https://idp.example.com o https://sts.windows.net/AZURE_TENANT_ID.
  • DISCOVERY_URI: facoltativo. L'URL da cui recuperare il documento di rilevamento OIDC, che sostituisce l'URL ISSUER_URI/.well-known/openid-configuration predefinito, ad esempio https://idp.example.com/.well-known/custom-openid-configuration. Lo schema, l'host e la porta devono corrispondere a ISSUER_URI e il percorso deve contenere un segmento /.well-known/ seguito da un suffisso non vuoto.
  • ATTRIBUTE_CONDITION: (Facoltativo) Un'espressione Common Expression Language (CEL) che limita le identità che possono autenticarsi, ad esempio assertion.sub.startsWith('repo:my-org/').
  • ACTOR_PROVIDERS: facoltativo. I nomi completi delle risorse di un massimo di tre provider di pool di identità del workload nello stesso pool autorizzati a emettere token attore per questo provider, ad esempio projects/my-project/locations/global/workloadIdentityPools/my-pool/providers/my-actor-provider. L'identificatore del progetto in ogni nome della risorsa deve corrispondere al formato dell'ID progetto o del numero di progetto che utilizzi per questo provider. Per saperne di più, consulta Configura la delega dell'identità e i token degli attori.

Metodo HTTP e URL:

POST https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID/providers?workloadIdentityPoolProviderId=PROVIDER_ID

Corpo JSON della richiesta:

{
  "displayName": "DISPLAY_NAME",
  "oidc": {
    "issuerUri": "ISSUER_URI",
    "discoveryUri": "DISCOVERY_URI"
  },
  "attributeMapping": {
    "google.subject": "assertion.sub"
  },
  "attributeCondition": "ATTRIBUTE_CONDITION",
  "actorProviders": [
    "ACTOR_PROVIDERS"
  ]
}

Per inviare la richiesta, espandi una di queste opzioni:

La risposta contiene un'operazione a lunga esecuzione che rappresenta la tua richiesta. Per verificare se la creazione del provider è stata completata, consulta Controlla lo stato di un'operazione a lunga esecuzione in questa pagina.

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider/operations/operation-1700000000011-0123456789abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolProviderOperationMetadata"
  },
  "done": false
}

Elenca i provider

Per elencare i provider di pool di identità del workload in un progetto, segui questi passaggi:

Console

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

    Vai a Pool di identità del workload

  2. Per visualizzare i provider di un pool di identità del workload, fai clic sull'icona Espandi nodo del pool.

gcloud

Il comando gcloud iam workload-identity-pools providers list elenca i provider in un pool di identità del workload.

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • PROJECT_ID: l'ID progetto Google Cloud . Gli ID progetto sono stringhe alfanumeriche, come my-project.
  • POOL_ID: l'ID del pool di identità del workload di cui vuoi elencare i provider, ad esempio my-pool. Per includere i provider eliminati temporaneamente nell'output, aggiungi il flag --show-deleted.

Esegui questo comando:

Linux, macOS o Cloud Shell

gcloud iam workload-identity-pools providers list \
    --project=PROJECT_ID \
    --location="global" \
    --workload-identity-pool="POOL_ID" \
    --format="json"

Windows (PowerShell)

gcloud iam workload-identity-pools providers list `
    --project=PROJECT_ID `
    --location="global" `
    --workload-identity-pool="POOL_ID" `
    --format="json"

Windows (cmd.exe)

gcloud iam workload-identity-pools providers list ^
    --project=PROJECT_ID ^
    --location="global" ^
    --workload-identity-pool="POOL_ID" ^
    --format="json"

Dovresti ricevere una risposta simile alla seguente:

[
  {
    "attributeMapping": {
      "google.subject": "assertion.sub"
    },
    "displayName": "My OIDC provider",
    "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider",
    "oidc": {
      "issuerUri": "https://idp.example.com"
    },
    "state": "ACTIVE"
  }
]

REST

Il metodo projects.locations.workloadIdentityPools.providers.list elenca i provider in un pool di identità del workload.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • PROJECT_ID: l'ID progetto Google Cloud . Gli ID progetto sono stringhe alfanumeriche, come my-project.
  • POOL_ID: l'ID del pool di identità del workload di cui vuoi elencare i provider, ad esempio my-pool. Per includere i provider eliminati temporaneamente nella risposta, aggiungi ?showDeleted=true all'URL della richiesta.

Metodo HTTP e URL:

GET https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID/providers

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "workloadIdentityPoolProviders": [
    {
      "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider",
      "displayName": "My OIDC provider",
      "state": "ACTIVE",
      "attributeMapping": {
        "google.subject": "assertion.sub"
      },
      "oidc": {
        "issuerUri": "https://idp.example.com"
      }
    }
  ]
}

Trova un fornitore

Per visualizzare i dettagli di un provider di pool di identità del workload specifico, segui questi passaggi:

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 di pool di identità del workload che vuoi visualizzare, quindi fai clic sull'icona Modifica. La console Google Cloud mostra informazioni dettagliate sul provider.

gcloud

Il comando gcloud iam workload-identity-pools providers describe recupera i dettagli di un provider di pool di identità del workload.

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • PROVIDER_ID: l'ID del provider del pool di identità del workload, ad esempio my-oidc-provider.
  • PROJECT_ID: l'ID progetto Google Cloud . Gli ID progetto sono stringhe alfanumeriche, come my-project.
  • POOL_ID: l'ID del pool di identità del workload che contiene il provider, ad esempio my-pool.

Esegui questo comando:

Linux, macOS o Cloud Shell

gcloud iam workload-identity-pools providers describe PROVIDER_ID \
    --project=PROJECT_ID \
    --location="global" \
    --workload-identity-pool="POOL_ID" \
    --format="json"

Windows (PowerShell)

gcloud iam workload-identity-pools providers describe PROVIDER_ID `
    --project=PROJECT_ID `
    --location="global" `
    --workload-identity-pool="POOL_ID" `
    --format="json"

Windows (cmd.exe)

gcloud iam workload-identity-pools providers describe PROVIDER_ID ^
    --project=PROJECT_ID ^
    --location="global" ^
    --workload-identity-pool="POOL_ID" ^
    --format="json"

Dovresti ricevere una risposta simile alla seguente:

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider",
  "displayName": "My OIDC provider",
  "state": "ACTIVE",
  "attributeMapping": {
    "google.subject": "assertion.sub"
  },
  "oidc": {
    "issuerUri": "https://idp.example.com"
  }
}

REST

Il metodo projects.locations.workloadIdentityPools.providers.get recupera i dettagli di un provider di pool di identità del workload.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • PROJECT_ID: l'ID progetto Google Cloud . Gli ID progetto sono stringhe alfanumeriche, come my-project.
  • POOL_ID: l'ID del pool di identità del workload che contiene il provider, ad esempio my-pool.
  • PROVIDER_ID: l'ID del provider del pool di identità del workload, ad esempio my-oidc-provider.

Metodo HTTP e URL:

GET https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider",
  "displayName": "My OIDC provider",
  "state": "ACTIVE",
  "attributeMapping": {
    "google.subject": "assertion.sub"
  },
  "oidc": {
    "issuerUri": "https://idp.example.com"
  }
}

Aggiorna un provider

Puoi attivare o disattivare un provider di pool di identità del workload. Puoi anche aggiornare i dati dell'account e la mappatura degli attributi, nonché il nome visualizzato e la descrizione.

Per aggiornare un provider di pool di identità del workload esistente, segui questi passaggi:

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, quindi fai clic sull'icona Modifica.

  4. Modifica le informazioni del provider e fai clic su Salva.

gcloud

Aggiorna un provider AWS

Il comando gcloud iam workload-identity-pools providers update-aws aggiorna un provider di pool di identità del workload AWS esistente.

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • PROVIDER_ID: l'ID del provider da aggiornare, ad esempio my-aws-provider.
  • PROJECT_ID: l'ID progetto Google Cloud . Gli ID progetto sono stringhe alfanumeriche, come my-project.
  • POOL_ID: l'ID del pool di identità del workload che contiene il provider, ad esempio my-pool.
  • DISPLAY_NAME: un nome visualizzato per il provider, fino a 32 caratteri, ad esempio Updated AWS provider.
  • DESCRIPTION: una descrizione del provider, fino a 256 caratteri. Per disattivare o attivare il provider, passa anche il flag --disabled o --no-disabled.

Esegui questo comando:

Linux, macOS o Cloud Shell

gcloud iam workload-identity-pools providers update-aws PROVIDER_ID \
    --project=PROJECT_ID \
    --location="global" \
    --workload-identity-pool="POOL_ID" \
    --display-name="DISPLAY_NAME" \
    --description="DESCRIPTION"

Windows (PowerShell)

gcloud iam workload-identity-pools providers update-aws PROVIDER_ID `
    --project=PROJECT_ID `
    --location="global" `
    --workload-identity-pool="POOL_ID" `
    --display-name="DISPLAY_NAME" `
    --description="DESCRIPTION"

Windows (cmd.exe)

gcloud iam workload-identity-pools providers update-aws PROVIDER_ID ^
    --project=PROJECT_ID ^
    --location="global" ^
    --workload-identity-pool="POOL_ID" ^
    --display-name="DISPLAY_NAME" ^
    --description="DESCRIPTION"

Dovresti ricevere una risposta simile alla seguente:

Update request issued for: [my-aws-provider]
Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-aws-provider/operations/operation-1700000000012-0123456789abcdef] to complete...done.
Updated workloadIdentityPoolProvider [my-aws-provider].

Aggiorna un provider OIDC

Il comando gcloud iam workload-identity-pools providers update-oidc aggiorna un provider di pool di identità del workload AWS esistente.

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • PROVIDER_ID: l'ID del provider OIDC da aggiornare, ad esempio my-oidc-provider.
  • PROJECT_ID: l'ID progetto Google Cloud . Gli ID progetto sono stringhe alfanumeriche, come my-project.
  • POOL_ID: l'ID del pool di identità del workload che contiene il provider, ad esempio my-pool.
  • DISPLAY_NAME: un nome visualizzato per il provider, fino a 32 caratteri, ad esempio Updated OIDC provider.
  • DESCRIPTION: una descrizione del provider, fino a 256 caratteri.
  • ISSUER_URI: l'URL HTTPS dell'emittente OIDC, ad esempio https://idp.example.com. Per disattivare o attivare il provider, passa anche il flag --disabled o --no-disabled.

Esegui questo comando:

Linux, macOS o Cloud Shell

gcloud iam workload-identity-pools providers update-oidc PROVIDER_ID \
    --project=PROJECT_ID \
    --location="global" \
    --workload-identity-pool="POOL_ID" \
    --display-name="DISPLAY_NAME" \
    --description="DESCRIPTION" \
    --issuer-uri="ISSUER_URI"

Windows (PowerShell)

gcloud iam workload-identity-pools providers update-oidc PROVIDER_ID `
    --project=PROJECT_ID `
    --location="global" `
    --workload-identity-pool="POOL_ID" `
    --display-name="DISPLAY_NAME" `
    --description="DESCRIPTION" `
    --issuer-uri="ISSUER_URI"

Windows (cmd.exe)

gcloud iam workload-identity-pools providers update-oidc PROVIDER_ID ^
    --project=PROJECT_ID ^
    --location="global" ^
    --workload-identity-pool="POOL_ID" ^
    --display-name="DISPLAY_NAME" ^
    --description="DESCRIPTION" ^
    --issuer-uri="ISSUER_URI"

Dovresti ricevere una risposta simile alla seguente:

Update request issued for: [my-oidc-provider]
Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider/operations/operation-1700000000013-0123456789abcdef] to complete...done.
Updated workloadIdentityPoolProvider [my-oidc-provider].

REST

Il metodo projects.locations.workloadIdentityPools.providers.patch aggiorna un provider di pool di identità del workload esistente.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • PROJECT_ID: l'ID progetto Google Cloud . Gli ID progetto sono stringhe alfanumeriche, come my-project.
  • POOL_ID: l'ID del pool di identità del workload che contiene il provider, ad esempio my-pool.
  • PROVIDER_ID: l'ID del provider da aggiornare, ad esempio my-aws-provider.
  • UPDATE_MASK: un elenco separato da virgole di campi da aggiornare, ad esempio displayName,description,disabled.
  • DISPLAY_NAME: un nome visualizzato per il provider, fino a 32 caratteri, ad esempio Updated AWS provider.
  • DESCRIPTION: una descrizione del provider, fino a 256 caratteri.
  • DISABLED: indica se il provider è disabilitato. Imposta su true per disattivare il provider o su false per attivarlo.

Metodo HTTP e URL:

PATCH https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID?updateMask=UPDATE_MASK

Corpo JSON della richiesta:

{
  "displayName": "DISPLAY_NAME",
  "description": "DESCRIPTION",
  "disabled": DISABLED
}

Per inviare la richiesta, espandi una di queste opzioni:

La risposta contiene un'operazione a lunga esecuzione che rappresenta la tua richiesta. Per verificare se l'aggiornamento del provider è stato completato, consulta Controlla lo stato di un'operazione a lunga esecuzione in questa pagina.

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-aws-provider/operations/operation-1700000000012-0123456789abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolProviderOperationMetadata"
  },
  "done": false
}

Elimina un provider

Quando elimini un provider di pool di identità del workload, le identità del provider perdono l'accesso alle risorse Google Cloud .

Puoi annullare l'eliminazione di un provider per un massimo di 30 giorni dopo l'eliminazione. Dopo 30 giorni, l'eliminazione è definitiva. Finché un provider non viene eliminato definitivamente, non puoi riutilizzare il suo nome durante la creazione di un nuovo provider.

Per eliminare un provider di pool di identità del workload, segui questi passaggi:

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 sul suo Nome visualizzato.

  3. Nel riquadro Provider, trova il provider che vuoi eliminare, quindi fai clic sull'icona Elimina.

  4. Fai clic su Elimina per eliminare il provider.

gcloud

Il comando gcloud iam workload-identity-pools providers delete elimina un provider di pool di identità del workload.

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • PROVIDER_ID: l'ID del provider del pool di identità del workload da eliminare, ad esempio my-oidc-provider.
  • PROJECT_ID: l'ID progetto Google Cloud . Gli ID progetto sono stringhe alfanumeriche, come my-project.
  • POOL_ID: l'ID del pool di identità del workload che contiene il provider, ad esempio my-pool.

Esegui questo comando:

Linux, macOS o Cloud Shell

gcloud iam workload-identity-pools providers delete PROVIDER_ID \
    --project=PROJECT_ID \
    --location="global" \
    --workload-identity-pool="POOL_ID"

Windows (PowerShell)

gcloud iam workload-identity-pools providers delete PROVIDER_ID `
    --project=PROJECT_ID `
    --location="global" `
    --workload-identity-pool="POOL_ID"

Windows (cmd.exe)

gcloud iam workload-identity-pools providers delete PROVIDER_ID ^
    --project=PROJECT_ID ^
    --location="global" ^
    --workload-identity-pool="POOL_ID"

Dovresti ricevere una risposta simile alla seguente:

Delete request issued for: [my-oidc-provider]
Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider/operations/operation-1700000000014-0123456789abcdef] to complete...done.
Deleted workloadIdentityPoolProvider [my-oidc-provider].

REST

Il metodo projects.locations.workloadIdentityPools.providers.delete elimina un provider di pool di identità del workload.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • PROJECT_ID: l'ID progetto Google Cloud . Gli ID progetto sono stringhe alfanumeriche, come my-project.
  • POOL_ID: l'ID del pool di identità del workload che contiene il provider, ad esempio my-pool.
  • PROVIDER_ID: l'ID del provider del pool di identità del workload da eliminare, ad esempio my-oidc-provider.

Metodo HTTP e URL:

DELETE https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID

Per inviare la richiesta, espandi una di queste opzioni:

La risposta contiene un'operazione a lunga esecuzione che rappresenta la tua richiesta. Per verificare se l'eliminazione del provider è stata completata, consulta Controlla lo stato di un'operazione a lunga esecuzione in questa pagina.

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider/operations/operation-1700000000014-0123456789abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolProviderOperationMetadata"
  },
  "done": false
}

Annulla l'eliminazione di un provider

Puoi recuperare un provider di pool di identità del workload eliminato entro 30 giorni dall'eliminazione. Per annullare l'eliminazione di un provider:

Console

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

    Vai a Pool di identità del workload

  2. Fai clic sul pulsante di attivazione/disattivazione Mostra i pool e i provider eliminati.

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

  4. Trova il provider che vuoi annullare l'eliminazione, quindi fai clic sulla relativa icona Ripristina.

  5. Fai clic su Ripristina. Il provider è stato ripristinato.

gcloud

Il comando gcloud iam workload-identity-pools providers undelete ripristina un provider di pool di identità del workload eliminato temporaneamente.

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • PROVIDER_ID: l'ID del provider del pool di identità del workload eliminato da ripristinare, ad esempio my-oidc-provider.
  • PROJECT_ID: l'ID progetto Google Cloud . Gli ID progetto sono stringhe alfanumeriche, come my-project.
  • POOL_ID: l'ID del pool di identità del workload che contiene il provider, ad esempio my-pool.

Esegui questo comando:

Linux, macOS o Cloud Shell

gcloud iam workload-identity-pools providers undelete PROVIDER_ID \
    --project=PROJECT_ID \
    --location="global" \
    --workload-identity-pool="POOL_ID"

Windows (PowerShell)

gcloud iam workload-identity-pools providers undelete PROVIDER_ID `
    --project=PROJECT_ID `
    --location="global" `
    --workload-identity-pool="POOL_ID"

Windows (cmd.exe)

gcloud iam workload-identity-pools providers undelete PROVIDER_ID ^
    --project=PROJECT_ID ^
    --location="global" ^
    --workload-identity-pool="POOL_ID"

Dovresti ricevere una risposta simile alla seguente:

Undelete request issued for: [my-oidc-provider]
Waiting for operation [projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider/operations/operation-1700000000015-0123456789abcdef] to complete...done.
Undeleted workloadIdentityPoolProvider [my-oidc-provider].

REST

Il metodo projects.locations.workloadIdentityPools.providers.undelete ripristina un provider di pool di identità del workload eliminato temporaneamente.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • PROJECT_ID: l'ID progetto Google Cloud . Gli ID progetto sono stringhe alfanumeriche, come my-project.
  • POOL_ID: l'ID del pool di identità del workload che contiene il provider, ad esempio my-pool.
  • PROVIDER_ID: l'ID del provider del pool di identità del workload eliminato da ripristinare, ad esempio my-oidc-provider.

Metodo HTTP e URL:

POST https://iam.googleapis.com/v1/projects/PROJECT_ID/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID:undelete

Corpo JSON della richiesta:

{}

Per inviare la richiesta, espandi una di queste opzioni:

La risposta contiene un'operazione a lunga esecuzione che rappresenta la tua richiesta. Per verificare se il ripristino del provider è stato completato, consulta Controlla lo stato di un'operazione a lunga esecuzione in questa pagina.

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/providers/my-oidc-provider/operations/operation-1700000000015-0123456789abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolProviderOperationMetadata"
  },
  "done": false
}

Controlla lo stato di un'operazione a lunga esecuzione

Quando utilizzi l'API REST, qualsiasi metodo che crea, aggiorna, elimina o ripristina un pool di identità del workload o un provider restituisce un'operazione a lunga esecuzione (LRO). L'operazione a lunga esecuzione monitora lo stato della richiesta e indica se la modifica è stata completata.

gcloud

Il comando gcloud iam workload-identity-pools operations describe restituisce lo stato di un'operazione a lunga esecuzione.

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

  • OPERATION_NAME: il nome completo della risorsa dell'operazione dal campo name della risposta originale:

    • Operazioni del pool: projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/operations/OPERATION_ID
    • Operazioni del provider: projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID/operations/OPERATION_ID

    Per le operazioni del provider, esegui invece il comando gcloud iam workload-identity-pools providers operations describe.

Esegui questo comando:

Linux, macOS o Cloud Shell

gcloud iam workload-identity-pools operations describe OPERATION_NAME

Windows (PowerShell)

gcloud iam workload-identity-pools operations describe OPERATION_NAME

Windows (cmd.exe)

gcloud iam workload-identity-pools operations describe OPERATION_NAME

Dovresti ricevere una risposta simile alla seguente:

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000000-0123456789abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolOperationMetadata"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPool",
    "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool",
    "displayName": "My workload pool",
    "description": "Workload identity pool for external workloads.",
    "state": "ACTIVE"
  }
}

REST

Il metodo projects.locations.workloadIdentityPools.operations.get restituisce lo stato di un'operazione a lunga esecuzione.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

  • OPERATION_NAME: il nome completo della risorsa dell'operazione dal campo name della risposta originale:

    • Operazioni del pool: projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/operations/OPERATION_ID
    • Operazioni del provider: projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/providers/PROVIDER_ID/operations/OPERATION_ID

Metodo HTTP e URL:

GET https://iam.googleapis.com/v1/OPERATION_NAME

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool/operations/operation-1700000000000-0123456789abcdef",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPoolOperationMetadata"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.iam.v1.WorkloadIdentityPool",
    "name": "projects/123456789012/locations/global/workloadIdentityPools/my-pool",
    "displayName": "My workload pool",
    "description": "Workload identity pool for external workloads.",
    "state": "ACTIVE"
  }
}

Se il campo done dell'operazione è false o viene omesso, continua a monitorare lo stato recuperando l'operazione ripetutamente. Utilizza il backoff esponenziale troncato per introdurre un ritardo tra le richieste. Quando il campo done è impostato su true, l'operazione è completata.

Gestisci i vincoli gestiti per la federazione delle identità per i workload

Puoi utilizzare i vincoli delle policy dell'organizzazione per limitare l'utilizzo delle risorse nella tua organizzazione Google Cloud .

Questa sezione descrive i vincoli consigliati quando utilizzi la federazione delle identità per i workload.

Gestisci gli IdP consentiti

In qualità di amministratore dell'organizzazione, puoi decidere con quali IdP la tua organizzazione può eseguire la federazione.

Per gestire gli IdP consentiti, attiva il vincolo dell'elenco constraints/iam.workloadIdentityPoolProviders nella policy dell'organizzazione per la tua organizzazione. Questo vincolo specifica gli URI emittente dei provider consentiti. Puoi utilizzare la consoleGoogle Cloud o Google Cloud CLI per abilitare questo vincolo.

Per consentire la federazione solo da AWS, crea un singolo vincolo con l'URI https://sts.amazonaws.com. L'esempio seguente mostra come creare questo vincolo utilizzando gcloud CLI:

gcloud resource-manager org-policies allow constraints/iam.workloadIdentityPoolProviders \
     https://sts.amazonaws.com --organization=ORGANIZATION_NUMBER

Puoi anche specificare quali ID account AWS hanno accesso alle tue risorseGoogle Cloud . Per specificare gli ID account, utilizza il vincolo di elenco constraints/iam.workloadIdentityPoolAwsAccounts:

gcloud resource-manager org-policies allow constraints/iam.workloadIdentityPoolAwsAccounts \
    ACCOUNT_ID --organization=ORGANIZATION_NUMBER

Per consentire la federazione da un solo provider OIDC, crea un singolo vincolo con il issuer_uri del provider consentito. Ad esempio, quanto segue consente la federazione solo da un tenant Azure specifico:

gcloud resource-manager org-policies allow constraints/iam.workloadIdentityPoolProviders \
     https://sts.windows.net/AZURE_TENANT_ID --organization=ORGANIZATION_NUMBER

La federazione da un IdP SAML è speciale perché le chiavi pubbliche utilizzate per convalidare l'asserzione vengono fornite quando viene configurato l'IdP SAML. Di conseguenza, è possibile che un utente malintenzionato tenti di caricare un documento di metadati SAML con l'ID entità dell'IdP della tua organizzazione utilizzando una chiave pubblica. In questo scenario, limitare la federazione utilizzando un ID entità dà solo un'illusione di sicurezza.

Per mitigare questo rischio, ti consigliamo vivamente di consentire la creazione di un pool di identità del workload con federazione SAML solo in un progetto Google Cloud gestito centralmente dalla tua organizzazione. Poi, se necessario, concedi alle identità esterne in quel pool di identità del workload l'accesso alle risorse della tua organizzazione.

Per consentire la federazione dagli IdP SAML, crea un vincolo che consenta la parola chiave speciale KEY_UPLOAD.

gcloud resource-manager org-policies allow constraints/iam.workloadIdentityPoolProviders \
     KEY_UPLOAD --organization=ORGANIZATION_NUMBER

Puoi ripetere questi comandi per consentire la federazione da altri provider.

Per bloccare la federazione da tutti i provider:

  1. Crea un file YAML contenente quanto segue:

    constraint: constraints/iam.workloadIdentityPoolProviders
    listPolicy:
      allValues: DENY
  2. Passa il file al comando gcloud resource-manager org-policies set-policy:

    gcloud resource-manager org-policies set-policy FILE_NAME.yaml \
        --organization=ORGANIZATION_NUMBER

Limita la creazione di chiavi dei account di servizio

La federazione delle identità per i workload ti consente di accedere alle risorse Google Cloud da all'esterno di Google Cloud senza utilizzare una chiave del account di servizio. Se non utilizzi mai le chiavi dei account di servizio per l'autenticazione, puoi contribuire a ridurre i rischi disabilitando la creazione delle chiavi.

Per disattivare la creazione di chiavi dei account di servizio, applica il vincolo booleano iam.disableServiceAccountKeyCreation nella policy dell'organizzazione per la tua organizzazione. Puoi anche applicare il vincolo booleano iam.disableServiceAccountKeyUpload, che disattiva il caricamento delle chiavi pubbliche per i service account.

Puoi utilizzare la consoleGoogle Cloud o gcloud CLI per attivare questi vincoli. Ad esempio, i seguenti comandi gcloud CLI attivano entrambi i vincoli:

gcloud resource-manager org-policies enable-enforce \
    constraints/iam.disableServiceAccountKeyCreation \
    --organization=ORGANIZATION_NUMBER
gcloud resource-manager org-policies enable-enforce \
    constraints/iam.disableServiceAccountKeyUpload \
    --organization=ORGANIZATION_NUMBER

Monitora la federazione delle identità per i workload

Puoi utilizzare le metriche di Cloud Monitoring per monitorare gli eventi di autenticazione per i provider e i pool di identità del workload. Per un elenco delle metriche disponibili, consulta Metriche IAM.

Passaggi successivi

Scopri di più sulla federazione delle identità per i workload.