Concedi l'autorizzazione dei flussi di lavoro per l'accesso alle risorse Google Cloud

Workflows utilizza account di servizio per concedere a flussi di lavoro l'accesso alle risorse Google Cloud. Gli account di servizio sono account speciali che fungono da identità di una persona fisica, ad esempio una funzione, un'applicazione o una VM. Ti offrono un modo per autenticare queste persone. Un account di servizio può essere considerato sia un'identità sia una risorsa.

  • Quando si considera un account di servizio come un'identità, è possibile concedere un ruolo a un account di servizio, consentendogli di accedere a una risorsa (ad esempio un flusso di lavoro).

  • Quando si considera un account di servizio come una risorsa, puoi concedere ruoli ad altri utenti affinché possano accedere all'account di servizio o gestirlo.

Un account di servizio è identificato dal suo indirizzo email, che è univoco per l'account.

Per ulteriori informazioni sulla configurazione dell'autenticazione con un'applicazione di produzione, consulta Autenticazione come account di servizio.

Account di servizio predefinito

Ogni flusso di lavoro è associato a un account di servizio Identity and Access Management (IAM) al momento della creazione del flusso di lavoro. Se non specifichi un account di servizio durante la creazione del flusso di lavoro, quest'ultimo utilizza l'account di servizio predefinito di Compute Engine per la propria identità. Puoi verificare l'account di servizio associato a un flusso di lavoro. In questo documento, vedi Verificare l'account di servizio associato di un flusso di lavoro.

Ti consigliamo di utilizzare l'account di servizio predefinito solo per test e sviluppo. Per gli ambienti di produzione, consigliamo vivamente di creare un nuovo account di servizio e assegnargli uno o più ruoli IAM che contengano le autorizzazioni minime richieste per la gestione dei flussi di lavoro.

Autorizzazioni account di servizio

Poiché gli account di servizio sono identità, puoi consentire a un account di servizio di accedere alle risorse del tuo progetto assegnandogli un ruolo, proprio come faresti per qualsiasi altra entità. Ad esempio, se vuoi consentire al tuo flusso di lavoro di inviare log a Cloud Logging, assicurati che all'account di servizio che esegue il flusso di lavoro sia stato concesso un ruolo che include l'autorizzazione logging.logEntries.create (ad esempio, il ruolo Logs Writer).

Tieni presente che l'account di servizio del flusso di lavoro non richiede il ruolo workflows.invoker, a meno che il flusso di lavoro non richiami se stesso o altri flussi di lavoro (ovvero, crei nuove esecuzioni del flusso di lavoro). Per ulteriori informazioni, consulta Richiamare Workflows.

Per saperne di più sulla concessione dei ruoli alle entità, inclusi gli account di servizio, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

Collegamento degli account di servizio alle risorse

Per creare una risorsa e collegare un account di servizio, devi disporre delle autorizzazioni necessarie per creare questa risorsa e collegare l'account di servizio alla risorsa. L'autorizzazione per collegare l'account di servizio a una risorsa è fornita da qualsiasi ruolo che include l'autorizzazione iam.serviceAccounts.actAs.

Per maggiori informazioni, consulta Ruoli per l'autenticazione dell'account di servizio.

Richiama Cloud Functions (2nd gen)

In Cloud Functions (2nd gen), le autorizzazioni di chiamata sono disponibili gestendo il servizio Cloud Run sottostante. Se il flusso di lavoro richiama un servizio Cloud Function (2ª generazione.), non è necessario concedere all'account di servizio del chiamante il ruolo Invoker di Cloud Functions (roles/cloudfunctions.invoker). Devi invece concedere il ruolo Invoker di Cloud Run (roles/run.invoker).

Per ulteriori informazioni, consulta Confronto tra le versioni di Cloud Functions.

Esegui il deployment di un flusso di lavoro con un account di servizio personalizzato

Puoi creare il tuo account di servizio gestito dall'utente per offrirti una maggiore flessibilità nel controllare l'accesso al tuo flusso di lavoro.

  1. Crea il tuo account di servizio e prendi nota del nome.

  2. Concedi all'account di servizio i ruoli appropriati in base alle risorse a cui il flusso di lavoro deve accedere per svolgere il proprio lavoro.

  3. Assicurati che tutte le entità che eseguono il deployment dei flussi di lavoro abbiano la possibilità di collegare l'account di servizio alle risorse. Se hai creato tu l'account di servizio, ti viene concessa automaticamente questa autorizzazione. Per maggiori informazioni, vedi Ruoli per l'autenticazione dell'account di servizio.

    Per ottenere l'autorizzazione necessaria per collegare un account di servizio a una risorsa, chiedi all'amministratore di concederti il ruolo IAM Utente account di servizio (roles/iam.serviceAccountUser) sul tuo progetto o sull'account di servizio. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

    Questo ruolo predefinito contiene l'autorizzazione iam.serviceAccounts.actAs, necessaria per collegare un account di servizio a una risorsa.

    Potresti riuscire a ottenere questa autorizzazione anche con i ruoli personalizzati o altri ruoli predefiniti.

    Concedi il ruolo nel progetto:

    gcloud projects add-iam-policy-binding WORKFLOWS_PROJECT_ID \
        --member=PRINCIPAL \
        --role='roles/iam.serviceAccountUser'

    In alternativa, concedi il ruolo nell'account di servizio:

    gcloud iam service-accounts add-iam-policy-binding SERVICE_ACCOUNT_RESOURCE_NAME \
        --member=PRINCIPAL \
        --role='roles/iam.serviceAccountUser'

    Sostituisci quanto segue:

    • WORKFLOWS_PROJECT_ID: l'ID progetto Google Cloud che contiene le risorse del flusso di lavoro
    • PRINCIPAL: un identificatore per il deploymenter del flusso di lavoro nel formato user|group|serviceAccount:email o domain:domain. Ad esempio:

      • user:test-user@gmail.com
      • group:admins@example.com
      • serviceAccount:test123@example.domain.com
      • domain:example.domain.com
    • SERVICE_ACCOUNT_RESOURCE_NAME: nome completo della risorsa dell'account di servizio. Ad esempio:

      projects/SERVICE_ACCOUNT_PROJECT_ID/serviceAccounts/SERVICE_ACCOUNT_NAME@SERVICE_ACCOUNT_PROJECT_ID.iam.gserviceaccount.com

      Dove:

      • SERVICE_ACCOUNT_PROJECT_ID è l'ID del progetto Google Cloud che contiene l'account di servizio.
      • SERVICE_ACCOUNT_NAME è il nome dell'account di servizio.
  4. Esegui il deployment del flusso di lavoro utilizzando l'account di servizio personalizzato.

Esegui il deployment di un flusso di lavoro con un account di servizio tra progetti

Per impostazione predefinita, non puoi creare un account di servizio in un progetto e collegarlo a una risorsa in un altro progetto. Le istruzioni riportate di seguito mostrano come collegare un account di servizio di un progetto a un flusso di lavoro in un altro progetto. Puoi quindi utilizzare l'account di servizio in diversi progetti per eseguire il deployment di un flusso di lavoro.

Se l'account di servizio e le risorse del flusso di lavoro si trovano in progetti diversi, dal progetto in cui si trova l'account di servizio, completa quanto segue:

  1. Nella console Google Cloud, vai alla pagina Criteri dell'organizzazione:

    Vai a Criteri dell'organizzazione

    Controlla il criterio dell'organizzazione per il progetto e assicurati che il vincolo booleano iam.disableCrossProjectServiceAccountUsage non sia applicato per il progetto. Per ulteriori informazioni, consulta Abilitare il collegamento degli account di servizio tra progetti.

  2. Crea il tuo account di servizio e prendi nota del nome.

  3. Concedi all'account di servizio i ruoli appropriati in base alle risorse a cui il flusso di lavoro deve accedere per svolgere il proprio lavoro.

  4. Concedi il ruolo Creatore token account di servizio (roles/iam.serviceAccountTokenCreator) all'agente di servizio Workflows. Ciò consente all'agente di servizio di gestire l'accesso tra progetti per l'account di servizio. L'agente di servizio è l'identità di un determinato servizio Google Cloud. Per maggiori informazioni, consulta Agenti di servizio.

    Console

    1. Nella console Google Cloud, vai alla pagina Flussi di lavoro:

      Vai a Flussi di lavoro

    2. Fai clic su Crea per creare un flusso di lavoro o seleziona il nome del flusso di lavoro da aggiornare.

    3. Nell'elenco Account di servizio, fai clic su Cambia progetto.

    4. Seleziona un account di servizio da un altro progetto.

    5. Se richiesto, concedi il ruolo roles/iam.serviceAccountTokenCreator all'agente di servizio Workflows.

    gcloud

    1. Concedi il ruolo roles/iam.serviceAccountTokenCreator all'agente di servizio Workflows:

      gcloud iam service-accounts add-iam-policy-binding SERVICE_ACCOUNT_RESOURCE_NAME \
          --member='serviceAccount:service-WORKFLOWS_PROJECT_NUMBER@gcp-sa-workflows.iam.gserviceaccount.com' \
          --role='roles/iam.serviceAccountTokenCreator'

      Sostituisci quanto segue:

      • SERVICE_ACCOUNT_RESOURCE_NAME: il nome completo della risorsa dell'account di servizio. Ad esempio:

        projects/SERVICE_ACCOUNT_PROJECT_ID/serviceAccounts/SERVICE_ACCOUNT_NAME@SERVICE_ACCOUNT_PROJECT_ID.iam.gserviceaccount.com

        Dove:

        • SERVICE_ACCOUNT_PROJECT_ID è l'ID del progetto Google Cloud che contiene l'account di servizio.
        • SERVICE_ACCOUNT_NAME è il nome dell'account di servizio.
      • WORKFLOWS_PROJECT_NUMBER: il numero del progetto Google Cloud che contiene le risorse del flusso di lavoro.

  5. Assicurati che tutte le entità che eseguono il deployment dei flussi di lavoro abbiano la possibilità di collegare l'account di servizio alle risorse. Se hai creato tu l'account di servizio, ti viene concessa automaticamente questa autorizzazione. Per maggiori informazioni, vedi Ruoli per l'autenticazione dell'account di servizio.

    Per ottenere l'autorizzazione necessaria per collegare un account di servizio a una risorsa, chiedi all'amministratore di concederti il ruolo IAM Utente account di servizio (roles/iam.serviceAccountUser) sul tuo progetto o sull'account di servizio. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

    Questo ruolo predefinito contiene l'autorizzazione iam.serviceAccounts.actAs, necessaria per collegare un account di servizio a una risorsa.

    Potresti riuscire a ottenere questa autorizzazione anche con i ruoli personalizzati o altri ruoli predefiniti.

    Console

    1. Nella console Google Cloud, vai alla pagina Flussi di lavoro:

      Vai a Flussi di lavoro

    2. Fai clic su Crea per creare un flusso di lavoro o seleziona il nome del flusso di lavoro da aggiornare.

    3. Nell'elenco Account di servizio, fai clic su Cambia progetto.

    4. Seleziona un account di servizio da un altro progetto.

    5. Se richiesto, concedi il ruolo roles/iam.serviceAccountUser nel progetto.

    gcloud

    Concedi il ruolo nel progetto:

    gcloud projects add-iam-policy-binding WORKFLOWS_PROJECT_ID \
        --member=PRINCIPAL \
        --role='roles/iam.serviceAccountUser'

    In alternativa, concedi il ruolo nell'account di servizio:

    gcloud iam service-accounts add-iam-policy-binding SERVICE_ACCOUNT_RESOURCE_NAME \
        --member=PRINCIPAL \
        --role='roles/iam.serviceAccountUser'

    Sostituisci quanto segue:

    • WORKFLOWS_PROJECT_ID: l'ID del progetto Google Cloud che contiene le risorse del flusso di lavoro
    • PRINCIPAL: un identificatore per il deployment del flusso di lavoro nel formato user|group|serviceAccount:email o domain:domain. Ad esempio:
      • user:test-user@gmail.com
      • group:admins@example.com
      • serviceAccount:test123@example.domain.com
      • domain:example.domain.com
    • SERVICE_ACCOUNT_RESOURCE_NAME: il nome completo della risorsa dell'account di servizio. Ad esempio:

      projects/SERVICE_ACCOUNT_PROJECT_ID/serviceAccounts/SERVICE_ACCOUNT_NAME@SERVICE_ACCOUNT_PROJECT_ID.iam.gserviceaccount.com

      Dove:

      • SERVICE_ACCOUNT_PROJECT_ID è l'ID del progetto Google Cloud che contiene l'account di servizio.
      • SERVICE_ACCOUNT_NAME è il nome dell'account di servizio.
  6. Esegui il deployment del flusso di lavoro utilizzando l'account di servizio tra progetti.

Verificare l'account di servizio associato a un flusso di lavoro

Puoi verificare quale account di servizio è associato a un determinato flusso di lavoro.

Console

  1. Nella console Google Cloud, vai alla pagina Workflows:

    Vai a Flussi di lavoro

  2. Nella pagina Flussi di lavoro, fai clic sul nome del flusso di lavoro.

  3. Nella pagina Dettagli flusso di lavoro, fai clic sulla scheda Dettagli.

    Viene visualizzato l'account di servizio associato al flusso di lavoro.

gcloud

  1. Apri un terminale.

  2. Inserisci questo comando:

    gcloud workflows describe MY_WORKFLOW
    

    Sostituisci MY_WORKFLOW con il nome del tuo flusso di lavoro.

    Viene restituita una descrizione completa del flusso di lavoro, che include l'account di servizio associato. Ad esempio:

    createTime: '2020-06-05T23:45:34.154213774Z'
    name: projects/myProject/locations/us-central1/workflows/myWorkflow
    serviceAccount: projects/my-project/serviceAccounts/012345678901-compute@developer.gserviceaccount.com
    sourceContents: [...]

Passaggi successivi