En este documento, se muestra cómo otorgar roles y permisos de Identity and Access Management (IAM) para colaborar con el enrutamiento de eventos desde Google Cloud y otras fuentes a los flujos de trabajo de destino con Eventarc.
Otorga al principal que invoca las APIs de Eventarc permisos para todo el proyecto (por ejemplo, el creador del activador de Eventarc):
- El rol de administrador de Eventarc te permite tener 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. La cuenta de servicio está asociada con un activador de Eventarc o un flujo de trabajo, y representa su identidad.
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.
- El rol Invocador de Workflows permite que el activador de Eventarc inicie la ejecución de un flujo de trabajo.
- Si tu flujo de trabajo envía registros a Cloud Logging, otorga un rol, como el de Escritor de registros, a la cuenta de servicio asociada con el flujo de trabajo.
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 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 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 permite tener 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: 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.Cuando creas un activador de Eventarc o cuando implementas un flujo de trabajo, necesitas este rol para asociar una cuenta de servicio administrada por el usuario con el activador o flujo de trabajo, y que represente su identidad. 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 deGoogle Cloud que contiene la cuenta de servicio.SERVICE_ACCOUNT_NAME: el nombre de la cuenta de servicio
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 pueda recibir eventos de 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 el rol de invocador de flujos de trabajo (
roles/workflows.invoker) en el proyecto a la cuenta de servicio asociada con tu activador de Eventarc para que pueda iniciar la ejecución del flujo de trabajo. .gcloud projects add-iam-policy-binding PROJECT_ID \ --member=serviceAccount:SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com \ --role=roles/workflows.invoker
Reemplaza
SERVICE_ACCOUNT_NAMEpor el nombre de tu cuenta de servicio que anotaste antes.
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 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.
Obtén información sobre cómo otorgar permiso a un flujo de trabajo para acceder a recursos de Google Cloud .
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.