Ruoli e autorizzazioni per i target di Cloud Run Functions

Questo documento mostra come concedere ruoli e autorizzazioni di Identity and Access Management (IAM) per supportare il routing degli eventi da Google Cloud e da altre origini a Cloud Run Functions utilizzando Eventarc.

  1. Concedi le autorizzazioni a livello di progetto e di deployment all'entità che crea i trigger ed esegue il deployment delle funzioni:

    1. Il ruolo Eventarc Admin ti offre il controllo completo su tutte le risorse Eventarc, inclusa la specifica di un account di servizio per il trigger al momento della creazione.

    2. Il ruolo Service Account User consente a un'entità di impersonare e utilizzare un account di servizio, inclusi il account di servizio trigger e i service account di runtime o build della funzione.

    3. A seconda di come esegui il deployment della funzione, i ruoli Cloud Run Source Developer e Service Usage Consumer (quando esegui il deployment con l'interfaccia a riga di comando gcloud run o l'API Cloud Run Admin) o il ruolo Cloud Functions Developer o Cloud Functions Admin (quando esegui il deployment con l'interfaccia a riga di comando gcloud functions o l'API Cloud Functions v2) ti consentono di creare e aggiornare le funzioni.

  2. Concedi le autorizzazioni del trigger Eventarc al service account del trigger: il ruolo Eventarc Event Receiver consente al trigger Eventarc di ricevere eventi dai provider di eventi. Non è necessario concedere il ruolo se esegui il routing di eventi diretti da Cloud Pub/Sub.

  3. Concedi le autorizzazioni di chiamata di Cloud Run Functions al service account del trigger: il ruolo Invoker Cloud Run consente al trigger Eventarc di richiamare una funzione Cloud Run autenticata.

  4. Concedi le autorizzazioni agli agenti di servizio Google:

    1. Il ruolo Eventarc Service Agent consente all'agente di servizio Eventarc di gestire le risorse di trasporto sottostanti e convalidare le origini eventi. Questo ruolo viene concesso per impostazione predefinita quando crei una risorsa Eventarc per la prima volta, ma devi ripristinarlo se viene rimosso.

    2. Se esegui il deployment di funzioni con l'interfaccia a riga di comando gcloud functions o l'API Cloud Functions v2, il ruolo Cloud Functions Service Agent consente all'agente di servizio Cloud Functions di creare e gestire i trigger Eventarc e i servizi Cloud Run sottostanti. Questo ruolo viene concesso per impostazione predefinita quando abiliti l'API Cloud Functions, ma devi ripristinarlo se viene rimosso.

    3. Se stai creando un trigger per gli eventi diretti da Cloud Storage, concedi il ruolo Pub/Sub Publisher all'agente di servizio Cloud Storage.

    4. Se hai attivato l'agente di servizio Cloud Pub/Sub il giorno 8 aprile 2021 o in una data precedente, concedi il ruolo Creatore token account di servizio all'agente di servizio Pub/Sub.

Per saperne di più sulla concessione dei ruoli IAM, consulta Gestisci l'accesso. Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Concedi le autorizzazioni a livello di progetto e di deployment

Se sei il creatore del progetto, ti viene concesso il ruolo di base Proprietario (roles/owner). Per impostazione predefinita, questo ruolo include le autorizzazioni necessarie per l'accesso completo alla maggior parte delle risorseGoogle Cloud . In caso contrario, i ruoli richiesti devono essere concessi da un amministratore sulla risorsa appropriata all'entità appropriata (nota anche come membro).

Ad esempio, un'entità può essere un Account Google (per gli utenti finali) o un service account (per applicazioni e workload di computing). Ogni entità ha il proprio identificatore, che in genere è un indirizzo email.

  1. Il ruolo Eventarc Admin (roles/eventarc.admin) ti offre il controllo completo su tutte le risorse Eventarc.

    Concedi il ruolo sul progetto:

    gcloud projects add-iam-policy-binding PROJECT_ID \
      --member=PRINCIPAL \
      --role=roles/eventarc.admin

    Sostituisci quanto segue:

    • PROJECT_ID: il tuo ID progetto Google Cloud .

    • PRINCIPAL: un identificatore per l'autore del trigger, che di solito ha il seguente formato: PRINCIPAL_TYPE:ID. Ad esempio user:my-user@example.com. Per un elenco completo dei possibili valori di PRINCIPAL_TYPE, consulta il riferimento per l'associazione delle policy.

  2. Il ruolo Service Account User (roles/iam.serviceAccountUser) consente a un'entità di eseguire operazioni come account di servizio.

    Questo ruolo è necessario per associare un account di servizio gestito dall'utente a un trigger Eventarc. È necessario anche per poter agire come service account di runtime durante il deployment di una funzione Cloud Run e come account di servizio di build durante il deployment dall'origine. Per ulteriori informazioni, consulta Ruoli per laccount di servizio account.

    Puoi concedere il ruolo nel progetto per consentire all'entità di simulare l'identità di più service account o concedere il ruolo nel account di servizio per consentire all'entità di simulare l'identità di un solo account di servizio specifico.

    Concedi il ruolo sul progetto:

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

    In alternativa, concedi il ruolo al account di servizio:

    gcloud iam service-accounts add-iam-policy-binding \
      projects/SERVICE_ACCOUNT_PROJECT_ID/serviceAccounts/SERVICE_ACCOUNT_NAME@SERVICE_ACCOUNT_PROJECT_ID.iam.gserviceaccount.com \
      --member=PRINCIPAL \
      --role=roles/iam.serviceAccountUser

    Sostituisci quanto segue:

    • SERVICE_ACCOUNT_PROJECT_ID: l'ID progetto Google Cloudche contiene il account di servizio.

    • SERVICE_ACCOUNT_NAME: il nome del service account.

  3. Concedi i ruoli necessari per eseguire il deployment della funzione Cloud Run in base al metodo di deployment:

Concedi le autorizzazioni per i trigger Eventarc

Ogni trigger Eventarc è associato a un account di servizio IAM al momento della creazione del trigger. Puoi specificare un account di servizio gestito dall'utente che il trigger utilizza come identità predefinita. Se non specifichi un account di servizio durante la creazione del trigger, quest'ultimo utilizza il service account predefinito di Compute Engine per la sua identità.

Ti consigliamo di creare il tuo service account gestito dall'utente per avere maggiore controllo e flessibilità nella gestione del trigger.

  1. Crea un account di servizio e annotane il nome:

    gcloud iam service-accounts create SERVICE_ACCOUNT_NAME \
      --description="DESCRIPTION" \
      --display-name="DISPLAY_NAME"

    Sostituisci quanto segue:

    • SERVICE_ACCOUNT_NAME: il nome del service account. Questo nome viene visualizzato nell'indirizzo email che identifica il account di servizio.

    • DESCRIPTION: una descrizione facoltativa del account di servizio.

    • DISPLAY_NAME: un nome del account di servizio da visualizzare nella console Google Cloud .

  2. Concedi il ruolo Eventarc Event Receiver (roles/eventarc.eventReceiver) nel progetto al account di servizio associato al trigger Eventarc in modo che il trigger possa ricevere eventi dai provider di eventi.

    Tieni presente che non è necessario concedere il ruolo Eventarc Event Receiver se esegui il routing di eventi diretti da Cloud Pub/Sub.

    gcloud projects add-iam-policy-binding PROJECT_ID \
      --member=serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com \
      --role=roles/eventarc.eventReceiver

    Sostituisci SERVICE_ACCOUNT_NAME con il nome del account di servizio che hai annotato nel passaggio precedente.

Concedi le autorizzazioni di chiamata di Cloud Run Functions

Per impostazione predefinita, Cloud Run Functions richiede l'autenticazione, il che significa che non può essere richiamato senza fornire le credenziali di autenticazione nella richiesta. Per i progetti con policy dell'organizzazione per la limitazione del dominio, utilizza una funzione di destinazione autenticata anziché una che consente l'accesso pubblico (non autenticato).

  1. Se esegui il routing degli eventi a una funzione Cloud Run autenticata, concedi il ruolo Cloud Run Invoker (roles/run.invoker) sul servizio Cloud Run sottostante al account di servizio associato al trigger Eventarc:

    gcloud run services add-iam-policy-binding FUNCTION_NAME \
      --region=REGION \
      --member=serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com \
      --role=roles/run.invoker

    Sostituisci quanto segue:

    • FUNCTION_NAME: il nome della tua funzione Cloud Run.

    • REGION: la regione in cui è stato eseguito il deployment della funzione.

  2. Facoltativamente, puoi concedere il ruolo su tutti i servizi, le funzioni e i job Cloud Run in un progetto Google Cloud . Per saperne di più, consulta Controlla l'accesso a tutti i servizi e i job di un progetto.

Tieni presente che se crei un trigger per una funzione Cloud Run autenticata senza concedere il ruolo Invoker di Cloud Run, il trigger viene creato correttamente ed è attivo. Tuttavia, il trigger non funzionerà come previsto e nei log verrà visualizzato un messaggio simile al seguente:

The request was not authenticated. Either allow unauthenticated invocations or set the proper Authorization header.

Concedi le autorizzazioni agli agenti di servizio Google

Alcuni servizi Google Cloud hanno agenti di servizio che consentono ai servizi di accedere alle tue risorse. Se un'API richiede un agente di servizio, Google lo crea dopo che hai attivato e utilizzato l'API.

  1. Se il ruolo Eventarc Service Agent (roles/eventarc.serviceAgent) è stato rimosso dal service agent Eventarc, concedi il ruolo al progetto in modo che Eventarc possa gestire le risorse di trasporto sottostanti e convalidare le origini eventi. In caso contrario, questo ruolo viene concesso per impostazione predefinita quando crei una risorsa Eventarc per la prima volta:

    gcloud projects add-iam-policy-binding PROJECT_ID \
      --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-eventarc.iam.gserviceaccount.com \
      --role=roles/eventarc.serviceAgent

    Sostituisci PROJECT_NUMBER con il tuo numero di progetto Google Cloud. Puoi trovare il numero di progetto nella pagina Benvenuto della console Google Cloud o eseguendo questo comando:

    gcloud projects describe PROJECT_ID --format='value(projectNumber)'
  2. Se esegui il deployment di funzioni con gcloud functions deploy o l'API Cloud Functions v2 e il ruolo Cloud Functions Service Agent (roles/cloudfunctions.serviceAgent) è stato rimosso dall'agente di servizio Cloud Functions, concedi il ruolo al progetto in modo che l'agente di servizio possa creare e gestire i trigger Eventarc e i servizi Cloud Run sottostanti. In caso contrario, questo ruolo viene concesso per impostazione predefinita quando abiliti l'API Cloud Functions:

    gcloud projects add-iam-policy-binding PROJECT_ID \
      --member=serviceAccount:service-PROJECT_NUMBER@gcf-admin-robot.iam.gserviceaccount.com \
      --role=roles/cloudfunctions.serviceAgent

    Tieni presente che questo ruolo è deprecato e si applica solo alle funzioni create utilizzando l'API Cloud Functions. Per le funzioni create utilizzando Cloud Run, consulta la pagina Ruoli e autorizzazioni di Cloud Run.

  3. Se stai creando un trigger per gli eventi diretti da Cloud Storage, per supportare la pubblicazione di messaggi in un argomento, concedi il ruolo Pub/Sub Publisher (roles/pubsub.publisher) nel progetto all'agente di servizio Cloud Storage:

    gcloud projects add-iam-policy-binding PROJECT_ID \
      --member=serviceAccount:service-PROJECT_NUMBER@gs-project-accounts.iam.gserviceaccount.com \
      --role=roles/pubsub.publisher
  4. Se hai attivato l'agente di servizio Cloud Pub/Sub il giorno 8 aprile 2021 o in una data precedente, per supportare le richieste push Pub/Sub autenticate, concedi il ruolo Creatore token account di servizio (roles/iam.serviceAccountTokenCreator) nel progetto all'agente di servizio Pub/Sub. In caso contrario, questo ruolo viene concesso per impostazione predefinita:

    gcloud projects add-iam-policy-binding PROJECT_ID \
      --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-pubsub.iam.gserviceaccount.com \
      --role=roles/iam.serviceAccountTokenCreator

Passaggi successivi