En este documento, se muestra cómo otorgar roles y permisos de Identity and Access Management (IAM) para admitir eventos de enrutamiento de Google Cloud y otras fuentes a Cloud Run Functions con Eventarc.
-
El rol de administrador de Eventarc te otorga control total sobre todos los recursos de Eventarc, incluida la especificación de una cuenta de servicio para el activador cuando la creas.
El rol de usuario de cuenta de servicio permite que una principal use la identidad de una cuenta de servicio, incluidas la cuenta de servicio del activador y las cuentas de servicio del entorno de ejecución o de compilación de la función.
Según cómo implementes tu función, los roles de Desarrollador de fuentes de Cloud Run y Consumidor de Service Usage (cuando se implementa con la CLI de
gcloud runo la API de Cloud Run Admin) o el rol de Desarrollador de Cloud Functions o Administrador de Cloud Functions (cuando se implementa con la CLI degcloud functionso la API de Cloud Functions v2) te permiten crear y actualizar funciones.
Otorga permisos de activador de Eventarc a la cuenta de servicio del activador: El rol de receptor de eventos de Eventarc permite que el activador de Eventarc reciba eventos de proveedores de eventos. No es necesario otorgar el rol si enrutas eventos directos desde Cloud Pub/Sub.
Otorga permisos de invocación de Cloud Run Functions a la cuenta de servicio del activador: El rol de invocador de Cloud Run permite que el activador de Eventarc invoque una función de Cloud Run autenticada.
Otorga permisos a los agentes de servicio de Google:
El rol de agente de servicio de Eventarc permite que el agente de servicio de Eventarc administre los recursos de transporte subyacentes y valide las fuentes de eventos. Este rol se otorga de forma predeterminada cuando creas un recurso de Eventarc por primera vez, pero debes restablecerlo si se quita.
Si implementas funciones con la CLI de
gcloud functionso la API de Cloud Functions v2, el rol de agente de servicio de Cloud Functions permite que el agente de servicio de Cloud Functions cree y administre activadores de Eventarc y servicios de Cloud Run subyacentes. Este rol se otorga de forma predeterminada cuando habilitas la API de Cloud Functions, pero debes restablecerlo si se quita.Si creas un activador para eventos directos desde Cloud Storage, otorga el rol de publicador de Pub/Sub al agente de servicio de Cloud Storage.
Si habilitaste el agente de servicio de Cloud Pub/Sub el 8 de abril de 2021 o antes de esa fecha, otorga el rol de creador de tokens de cuenta de servicio al agente de servicio de Pub/Sub.
Para obtener más información sobre cómo otorgar roles de IAM, consulta Administra el acceso. También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.
Otorga permisos de implementación y en todo el proyecto
Si eres el creador del proyecto, se te otorga el
rol de propietario básico (roles/owner). De forma
predeterminada, este rol incluye los permisos necesarios para obtener acceso completo a la mayoría
de los recursos deGoogle Cloud . De lo contrario, un administrador debe otorgar los roles
necesarios en el recurso apropiado a la principal apropiada (también
conocida como miembro).
Por ejemplo, una principal puede ser una Cuenta de Google (para usuarios finales) o una cuenta de servicio (para aplicaciones y cargas de trabajo de procesamiento). Cada principal tiene su propio identificador, que suele ser una dirección de correo electrónico.
El rol de administrador de Eventarc (
roles/eventarc.admin) te otorga control total sobre todos los recursos de Eventarc.Otorga el rol en el proyecto:
gcloud projects add-iam-policy-binding PROJECT_ID \ --member=PRINCIPAL \ --role=roles/eventarc.admin
Reemplaza lo siguiente:
PROJECT_ID: Es el ID del proyecto de Google Cloud .PRINCIPAL: Es un identificador para el creador del activador, que, por lo general, tiene el siguiente formato:PRINCIPAL_TYPE:ID. Por ejemplo,user:my-user@example.com. Si deseas obtener una lista completa de los valoresPRINCIPAL_TYPEposibles, consulta la referencia sobre la vinculación de políticas.
El rol de usuario de la cuenta de servicio (
roles/iam.serviceAccountUser) permite que una principal ejecute operaciones como una cuenta de servicio.Necesitas este rol para asociar una cuenta de servicio administrada por el usuario con un activador de Eventarc. También la necesitas para que puedas actuar como la cuenta de servicio del entorno de ejecución cuando implementes una función de Cloud Run y como la cuenta de servicio de compilación cuando implementes desde la fuente. Si deseas obtener más información, consulta Roles para la autenticación de cuentas de servicio.
Puedes otorgar el rol en el proyecto para permitir que la principal use la identidad de varias cuentas de servicio o puedes otorgar el rol en la cuenta de servicio para permitir que la principal actúe en nombre de una cuenta de servicio específica.
Otorga el rol en el proyecto:
gcloud projects add-iam-policy-binding PROJECT_ID \ --member=PRINCIPAL \ --role=roles/iam.serviceAccountUser
O bien, otorga el rol en la cuenta de servicio:
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
Reemplaza lo siguiente:
SERVICE_ACCOUNT_PROJECT_ID: Es el ID del proyecto de Google Cloud que contiene la cuenta de servicio.SERVICE_ACCOUNT_NAME: el nombre de la cuenta de servicio
Otorga los roles necesarios para implementar tu función de Cloud Run según cómo la implementes:
Implementa con
gcloud run deployo la API de Cloud Run Admin: Otorga el rol de desarrollador de fuentes de Cloud Run (roles/run.sourceDeveloper) y el rol de consumidor de Service Usage (roles/serviceusage.serviceUsageConsumer) en el proyecto. Para obtener más información, incluidos los roles de la cuenta de servicio de Cloud Build necesarios para compilar desde el código fuente, consulta Roles necesarios para implementar Cloud Run Functions y Crea un activador para funciones.Implementa con
gcloud functions deployo la API de Cloud Functions v2: Otorga el rol de desarrollador de Cloud Functions (roles/cloudfunctions.developer) o el rol de administrador de Cloud Functions (roles/cloudfunctions.admin) en el proyecto. Para obtener más información, incluidos los roles de la cuenta de servicio de Cloud Build necesarios para compilar desde el código fuente, consulta Configuración adicional para la implementación y Control de acceso con IAM.
Otorga permisos de activador de Eventarc
Cada activador de Eventarc se asocia a una cuenta de servicio de IAM en el momento en que se crea el activador. Puedes especificar una cuenta de servicio administrada por el usuario que el activador use como su identidad predeterminada. Si no especificas una cuenta de servicio durante la creación del activador, este usa la cuenta de servicio predeterminada de Compute Engine para su identidad.
Te recomendamos crear tu propia cuenta de servicio administrada por el usuario para tener mayor control y flexibilidad cuando administres tu activador.
Crea una cuenta de servicio y anota su nombre:
gcloud iam service-accounts create SERVICE_ACCOUNT_NAME \ --description="DESCRIPTION" \ --display-name="DISPLAY_NAME"
Reemplaza lo siguiente:
SERVICE_ACCOUNT_NAME: el nombre de la cuenta de servicio Este nombre aparecerá en la dirección de correo electrónico que identifica la cuenta de servicio.DESCRIPTION: Es una descripción opcional de la cuenta de servicio.DISPLAY_NAME: Es un nombre de cuenta de servicio que se mostrará en la consola de Google Cloud .
Otorga el rol de receptor de eventos de Eventarc (
roles/eventarc.eventReceiver) en el proyecto a la cuenta de servicio asociada con tu activador de Eventarc para que el activador pueda recibir eventos de los proveedores de eventos.Ten en cuenta que no necesitas otorgar el rol de receptor de eventos de Eventarc si enrutas eventos directos desde 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
Reemplaza
SERVICE_ACCOUNT_NAMEpor el nombre de tu cuenta de servicio que anotaste en el paso anterior.
Otorga permisos de invocación de Cloud Run Functions
De forma predeterminada, las funciones de Cloud Run requieren autenticación, lo que significa que no se pueden invocar sin proporcionar credenciales de autenticación en la solicitud. Para proyectos con políticas de la organización de restricción de dominio, usa una función de destino autenticada en lugar de una que permita el acceso público (sin autenticar).
Si enrutas eventos a una función de Cloud Run autenticada, otorga el rol de invocador de Cloud Run (
roles/run.invoker) en el servicio de Cloud Run subyacente a la cuenta de servicio asociada con tu activador de 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
Reemplaza lo siguiente:
FUNCTION_NAME: Es el nombre de tu función de Cloud Run.REGION: Es la región en la que se implementa tu función.
De manera opcional, puedes otorgar el rol en todos los servicios, funciones y trabajos de Cloud Run en un proyecto de Google Cloud . Para obtener más información, consulta Controla el acceso en todos los servicios y trabajos de un proyecto.
Ten en cuenta que, si creas un activador para una función de Cloud Run autenticada sin otorgar el rol de invocador de Cloud Run, el activador se crea de forma correcta y está activo. Sin embargo, el activador no funcionará como se espera y aparecerá en los registros un mensaje similar al siguiente:
The request was not authenticated. Either allow unauthenticated
invocations or set the proper Authorization header.
Otorga permisos a los agentes de servicio de Google
Algunos servicios de Google Cloud tienen agentes de servicio que permiten que los servicios accedan a tus recursos. Si una API requiere un agente de servicio, Google crea el agente de servicio después de que activas y usas la API.
Si se quitó el rol de agente de servicio de Eventarc (
roles/eventarc.serviceAgent) del agente de servicio de Eventarc, otorga el rol en el proyecto para que Eventarc pueda administrar los recursos de transporte subyacentes y validar las fuentes de eventos. De lo contrario, este rol se otorga de forma predeterminada cuando creas un recurso de Eventarc por primera vez:gcloud projects add-iam-policy-binding PROJECT_ID \ --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-eventarc.iam.gserviceaccount.com \ --role=roles/eventarc.serviceAgent
Reemplaza
PROJECT_NUMBERpor el número del proyecto de Google Cloud. Para encontrar el número del proyecto, ve a la página de bienvenida de la consola de Google Cloud o ejecuta el siguiente comando:gcloud projects describe PROJECT_ID --format='value(projectNumber)'
Si implementas funciones con
gcloud functions deployo la API de Cloud Functions v2 y se quitó el rol de agente de servicio de Cloud Functions (roles/cloudfunctions.serviceAgent) del agente de servicio de Cloud Functions, otorga el rol en el proyecto para que el agente de servicio pueda crear y administrar activadores de Eventarc y servicios de Cloud Run subyacentes. De lo contrario, este rol se otorga de forma predeterminada cuando habilitas la API de 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
Ten en cuenta que este rol dejó de estar disponible y solo se aplica a las funciones creadas con la API de Cloud Functions. Para las funciones creadas con Cloud Run, consulta la página Roles y permisos de Cloud Run.
Si creas un activador para eventos directos desde Cloud Storage, para admitir la publicación de mensajes en un tema, otorga el rol de publicador de Pub/Sub (
roles/pubsub.publisher) en el proyecto al agente de servicio de 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
Si habilitaste el agente de servicio de Cloud Pub/Sub el 8 de abril de 2021 o antes de esa fecha, para admitir solicitudes de envío de Pub/Sub autenticadas, otorga el rol de creador de tokens de cuenta de servicio (
roles/iam.serviceAccountTokenCreator) en el proyecto al agente de servicio de Pub/Sub. De lo contrario, este rol se otorga de forma predeterminada:gcloud projects add-iam-policy-binding PROJECT_ID \ --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-pubsub.iam.gserviceaccount.com \ --role=roles/iam.serviceAccountTokenCreator
¿Qué sigue?
Obtén información sobre las opciones de control de acceso en Eventarc.
Aprende a activar servicios y funciones de Cloud Run con eventos.
Obtén más información sobre el control de acceso con IAM para Cloud Run Functions.
Obtén información sobre las prácticas recomendadas para usar cuentas de servicio.
Aprende a describir un activador y verificar su cuenta de servicio asociada.