Rollen und Berechtigungen für Cloud Run Functions-Ziele

In diesem Dokument erfahren Sie, wie Sie IAM-Rollen (Identity and Access Management) und -Berechtigungen erteilen, um Routingereignisse von Google Cloud und anderen Quellen zu Cloud Run Functions mit Eventarc zu unterstützen:

  1. Weisen Sie dem Hauptkonto, das Trigger erstellt und Funktionen bereitstellt, projektweite und Bereitstellungsberechtigungen zu:

    1. Mit der Rolle Eventarc-Administrator haben Sie die vollständige Kontrolle über alle Eventarc-Ressourcen, einschließlich der Angabe eines Dienstkontos für den Trigger beim Erstellen.

    2. Mit der Rolle Dienstkontonutzer kann ein Hauptkonto die Identität eines Dienstkontos übernehmen und verwenden, einschließlich des Trigger-Dienstkontos und der Funktionslaufzeit- oder Build-Dienstkonten.

    3. Je nachdem, wie Sie Ihre Funktion bereitstellen, können Sie mit den Rollen Cloud Run Source Developer und Service Usage Consumer (bei Bereitstellung mit der gcloud run-CLI oder der Cloud Run Admin API) oder den Rollen Cloud Functions-Entwickler oder Cloud Functions-Administrator (bei Bereitstellung mit der gcloud functions-CLI oder der Cloud Functions v2 API) Funktionen erstellen und aktualisieren.

  2. Eventarc-Trigger-Berechtigungen für das Trigger-Dienstkonto erteilen: Mit der Rolle Eventarc-Ereignisempfänger kann Ihr Eventarc-Trigger Ereignisse von Ereignisanbietern empfangen. Sie müssen die Rolle nicht zuweisen, wenn Sie direkte Ereignisse aus Cloud Pub/Sub weiterleiten.

  3. Cloud Run Functions-Aufrufberechtigungen für das Triggerdienstkonto erteilen: Mit der Rolle Cloud Run-Aufrufer kann Ihr Eventarc-Trigger eine authentifizierte Cloud Run-Funktion aufrufen.

  4. Gewähren Sie Berechtigungen für Google-Dienst-Agents:

    1. Mit der Rolle Eventarc-Dienst-Agent kann der Eventarc-Dienst-Agent zugrunde liegende Transportressourcen verwalten und Ereignisquellen validieren. Diese Rolle wird standardmäßig gewährt, wenn Sie zum ersten Mal eine Eventarc-Ressource erstellen. Sie müssen sie jedoch wiederherstellen, wenn sie entfernt wird.

    2. Wenn Sie Funktionen mit der gcloud functions-Befehlszeile oder der Cloud Functions v2 API bereitstellen, kann der Cloud Functions-Dienst-Agent mit der Rolle Cloud Functions-Dienst-Agent Eventarc-Trigger und zugrunde liegende Cloud Run-Dienste erstellen und verwalten. Diese Rolle wird standardmäßig gewährt, wenn Sie die Cloud Functions API aktivieren. Sie müssen sie jedoch wiederherstellen, wenn sie entfernt wird.

    3. Wenn Sie einen Trigger für direkte Ereignisse aus Cloud Storage erstellen, weisen Sie dem Cloud Storage-Dienst-Agent die Rolle Pub/Sub-Publisher zu.

    4. Wenn Sie den Cloud Pub/Sub-Dienst-Agent am oder vor dem 8. April 2021 aktiviert haben, weisen Sie dem Pub/Sub-Dienst-Agent die Rolle Ersteller von Dienstkonto-Tokens zu.

Weitere Informationen zum Zuweisen von IAM-Rollen finden Sie unter Zugriff verwalten. Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Projektweite Berechtigungen und Bereitstellungsberechtigungen gewähren

Wenn Sie der Projektersteller sind, wird Ihnen die einfache Inhaberrolle (roles/owner) zugewiesen. Standardmäßig enthält diese Rolle die Berechtigungen, die für den vollständigen Zugriff auf die meistenGoogle Cloud -Ressourcen erforderlich sind. Andernfalls müssen die erforderlichen Rollen von einem Administrator für die entsprechende Ressource dem entsprechenden Hauptkonto (auch als Mitglied bezeichnet) gewährt werden.

Ein Hauptkonto kann beispielsweise ein Google-Konto (für Endnutzer) oder ein Dienstkonto (für Anwendungen und Computing-Arbeitslasten) sein. Jedes Hauptkonto hat eine eigene Kennung, die normalerweise eine E-Mail-Adresse ist.

  1. Mit der Eventarc-Administratorrolle (roles/eventarc.admin) können Sie alle Eventarc-Ressourcen vollständig steuern.

    Weisen Sie dem Projekt die Rolle zu:

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

    Ersetzen Sie Folgendes:

    • PROJECT_ID: Projekt-ID in Google Cloud .

    • PRINCIPAL: Die Kennung des Triggererstellers, die normalerweise das folgende Format hat: PRINCIPAL_TYPE:ID. Beispiel: user:my-user@example.com. Eine vollständige Liste der möglichen PRINCIPAL_TYPE-Werte finden Sie in der Referenz zur Richtlinienbindung.

  2. Mit der Rolle „Dienstkontonutzer“ (roles/iam.serviceAccountUser) kann ein Hauptkonto Vorgänge als Dienstkonto ausführen.

    Sie benötigen diese Rolle, damit Sie ein vom Nutzer verwaltetes Dienstkonto mit einem Eventarc-Trigger verknüpfen können. Sie benötigen sie auch, damit Sie bei der Bereitstellung einer Cloud Run-Funktion als Laufzeitdienstkonto und bei der Bereitstellung aus der Quelle als Build-Dienstkonto fungieren können. Weitere Informationen finden Sie unter Rollen für die Dienstkontoauthentifizierung.

    Sie können entweder die Rolle für das Projekt zuweisen, damit das Hauptkonto die Identität mehrerer Dienstkonten übernehmen kann, oder Sie gewähren die Rolle für das Dienstkonto, damit das Hauptkonto nur die Identität eines bestimmten Dienstkontos übernehmen kann.

    Weisen Sie dem Projekt die Rolle zu:

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

    Oder weisen Sie dem Dienstkonto die Rolle zu:

    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

    Ersetzen Sie Folgendes:

    • SERVICE_ACCOUNT_PROJECT_ID: die Google Cloud-Projekt-ID, die das Dienstkonto enthält.

    • SERVICE_ACCOUNT_NAME: der Name des Dienstkontos.

  3. Weisen Sie die Rollen zu, die für die Bereitstellung Ihrer Cloud Run-Funktion erforderlich sind, je nachdem, wie Sie sie bereitstellen:

Eventarc-Trigger-Berechtigungen erteilen

Jeder Eventarc-Trigger ist zum Zeitpunkt der Erstellung des Triggers mit einem IAM-Dienstkonto verknüpft. Sie können ein vom Nutzer verwaltetes Dienstkonto angeben, das der Trigger als Standardidentität verwendet. Wenn Sie beim Erstellen des Triggers kein Dienstkonto angeben, verwendet der Trigger das Compute Engine-Standarddienstkonto für seine Identität.

Wir empfehlen Ihnen, ein eigenes nutzerverwaltetes Dienstkonto zu erstellen, um mehr Kontrolle und Flexibilität bei der Verwaltung des Triggers zu erhalten.

  1. Erstellen Sie ein Dienstkonto und notieren Sie sich seinen Namen:

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

    Ersetzen Sie dabei Folgendes:

    • SERVICE_ACCOUNT_NAME: der Name des Dienstkontos. Dieser Name wird in der E-Mail-Adresse angezeigt, die das Dienstkonto identifiziert.

    • DESCRIPTION: Eine optionale Beschreibung des Dienstkontos.

    • DISPLAY_NAME: ein Dienstkontoname, der in der Google Cloud Console angezeigt werden soll.

  2. Weisen Sie dem Dienstkonto, das Ihrem Eventarc-Trigger zugeordnet ist, die Rolle "Eventarc-Ereignisempfänger" (roles/eventarc.eventReceiver) für das Projekt zu, damit der Trigger Ereignisse vom Ereignisanbieter empfangen kann.

    Beachten Sie, dass Sie die Rolle „Eventarc-Ereignisempfänger“ nicht zuweisen müssen, wenn Sie direkte Ereignisse aus Cloud Pub/Sub weiterleiten.

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

    Ersetzen Sie SERVICE_ACCOUNT_NAME durch den Namen Ihres Dienstkontos, den Sie im vorherigen Schritt notiert haben.

Aufrufberechtigungen für Cloud Run Functions gewähren

Standardmäßig erfordern Cloud Run-Funktionen eine Authentifizierung. Das bedeutet, dass sie nicht aufgerufen werden können, ohne dass in der Anfrage Authentifizierungsdaten angegeben werden. Für Projekte mit Organisationsrichtlinien für die domaineingeschränkte Freigabe verwenden Sie stattdessen eine authentifizierte Zielfunktion, anstelle einer Funktion, die den öffentlichen (unauthentifizierten) Zugriff erlaubt.

  1. Wenn Sie Ereignisse an eine authentifizierte Cloud Run-Funktion weiterleiten, weisen Sie dem Dienstkonto, das mit Ihrem Eventarc-Trigger verknüpft ist, die Rolle Cloud Run-Aufrufer (roles/run.invoker) für den zugrunde liegenden Cloud Run-Dienst zu:

    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

    Ersetzen Sie Folgendes:

    • FUNCTION_NAME: der Name Ihrer Cloud Run-Funktion.

    • REGION: die Region, in der Ihre Funktion bereitgestellt wird.

  2. Optional können Sie die Rolle für alle Cloud Run-Dienste, -Funktionen und -Jobs in einem Google Cloud -Projekt zuweisen. Weitere Informationen finden Sie unter Zugriff auf alle Dienste und Jobs in einem Projekt steuern.

Wenn Sie einen Trigger für eine authentifizierte Cloud Run-Funktion erstellen, ohne die Rolle „Cloud Run Invoker“ zuzuweisen, wird der Trigger erfolgreich erstellt und ist aktiv. Der Trigger funktioniert jedoch nicht wie erwartet und in den Logs wird eine Meldung wie die folgende angezeigt:

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

Berechtigungen für Google-Dienst-Agents erteilen

Einige Google Cloud -Dienste haben Dienst-Agents, mit denen die Dienste auf Ihre Ressourcen zugreifen können. Wenn eine API einen Dienst-Agent erfordert, erstellt Google den Dienst-Agent, nachdem Sie die API aktiviert und verwendet haben.

  1. Wenn die Rolle „Eventarc-Dienst-Agent“ (roles/eventarc.serviceAgent) vom Eventarc-Dienst-Agent entfernt wurde, weisen Sie die Rolle dem Projekt zu, damit Eventarc die zugrunde liegenden Transportressourcen verwalten und Ereignisquellen validieren kann. Andernfalls wird diese Rolle standardmäßig zugewiesen, wenn Sie zum ersten Mal eine Eventarc-Ressource erstellen:

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

    Ersetzen Sie PROJECT_NUMBER durch die Google CloudProjektnummer. Sie finden Ihre Projektnummer auf der Willkommensseite der Google Cloud Console oder durch Ausführen des folgenden Befehls:

    gcloud projects describe PROJECT_ID --format='value(projectNumber)'
  2. Wenn Sie Funktionen mit gcloud functions deploy oder der Cloud Functions v2 API bereitstellen und die Rolle „Cloud Functions-Dienst-Agent“ (roles/cloudfunctions.serviceAgent) vom Cloud Functions-Dienst-Agent entfernt wurde, weisen Sie die Rolle dem Projekt zu, damit der Dienst-Agent Eventarc-Trigger und zugrunde liegende Cloud Run-Dienste erstellen und verwalten kann. Andernfalls wird diese Rolle standardmäßig zugewiesen, wenn Sie die Cloud Functions API aktivieren:

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

    Diese Rolle wurde eingestellt und gilt nur für Funktionen, die mit der Cloud Functions API erstellt wurden. Informationen zu Funktionen, die mit Cloud Run erstellt wurden, finden Sie auf der Seite Cloud Run-Rollen und -Berechtigungen.

  3. Wenn Sie einen Trigger für direkte Ereignisse aus Cloud Storage erstellen, um die Veröffentlichung von Nachrichten zu einem Thema zu unterstützen, gewähren Sie dem Cloud Storage-Dienst-Agent die Pub/Sub-Publisher-Rolle (roles/pubsub.publisher) für das Projekt:

    gcloud projects add-iam-policy-binding PROJECT_ID \
      --member=serviceAccount:service-PROJECT_NUMBER@gs-project-accounts.iam.gserviceaccount.com \
      --role=roles/pubsub.publisher
  4. Wenn Sie den Cloud Pub/Sub-Dienst-Agent am oder vor dem 8. April 2021 aktiviert haben, damit authentifizierte Pub/Sub-Push-Anfragen unterstützt werden, müssen Sie dem Pub/Sub-Dienst-Agent die Rolle „Dienstkonto-Token-Ersteller“ (roles/iam.serviceAccountTokenCreator) für das Projekt zuweisen. Andernfalls wird diese Rolle standardmäßig zugewiesen:

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

Nächste Schritte