Identity and Access Management (IAM) te permite controlar el acceso de los usuarios y grupos a los recursos del proyecto. En este documento, se describen los permisos de IAM relevantes para Managed Service para Apache Spark y los roles de IAM que otorgan esos permisos.
Permisos de Managed Service para Apache Spark en clústeres
Los permisos de Managed Service para Apache Spark permiten que los usuarios, incluidas las
cuentas de servicio,
realicen acciones en los clústeres, los trabajos, las operaciones y las plantillas de flujo de trabajo de Managed Service para Apache Spark. Por ejemplo, el permiso dataproc.clusters.create
permite que un usuario cree clústeres de Managed Service para Apache Spark en un proyecto.
Por lo general, no otorgas permisos, sino roles, que incluyen uno o más permisos.
En las siguientes tablas, se enumeran los permisos necesarios para llamar a las APIs (métodos) de Managed Service para Apache Spark. Las tablas se organizan según las APIs asociadas con cada recurso de Managed Service para Apache Spark (clústeres, trabajos, operaciones y plantillas de flujo de trabajo).
Permiso de alcance: El alcance de los permisos de Managed Service para Apache Spark
que se enumeran en las siguientes tablas es el proyecto de Google Cloud
que lo contiene (alcance decloud-platform). Consulta
Permisos de la cuenta de servicio.
Ejemplos:
dataproc.clusters.createpermite la creación de clústeres de Managed Service para Apache Spark en el proyecto contenedor.dataproc.jobs.createpermite el envío de trabajos de Managed Service para Apache Spark a clústeres de Managed Service para Apache Spark en el proyecto contenedor.dataproc.clusters.listpermite enumerar los detalles de los clústeres de Managed Service para Apache Spark en el proyecto que los contiene.
Permisos necesarios para los métodos de clústeres
| Método | Permisos necesarios |
|---|---|
| projects.regions.clusters.create 1, 2 | dataproc.clusters.create |
| projects.regions.clusters.get | dataproc.clusters.get |
| projects.regions.clusters.list | dataproc.clusters.list |
| projects.regions.clusters.patch1, 2, 3 | dataproc.clusters.update |
| projects.regions.clusters.delete1 | dataproc.clusters.delete |
| projects.regions.clusters.start | dataproc.clusters.start |
| projects.regions.clusters.stop | dataproc.clusters.stop |
| projects.regions.clusters.getIamPolicy | dataproc.clusters.getIamPolicy |
| projects.regions.clusters.setIamPolicy | dataproc.clusters.setIamPolicy |
Notas:
- El permiso
dataproc.operations.gettambién es necesario para obtener actualizaciones de estado de Google Cloud CLI. - El permiso
dataproc.clusters.gettambién es necesario para obtener el resultado de la operación de Google Cloud CLI. dataproc.autoscalingPolicies.usetambién es necesario para habilitar una política de ajuste de escala automático en un clúster.
Permisos necesarios para los métodos de trabajos
| Método | Permisos necesarios |
|---|---|
| projects.regions.jobs.submit 1, 2 | dataproc.jobs.create dataproc.clusters.use |
| projects.regions.jobs.get | dataproc.jobs.get |
| projects.regions.jobs.list | dataproc.jobs.list |
| projects.regions.jobs.cancel1 | dataproc.jobs.cancel |
| projects.regions.jobs.patch1 | dataproc.jobs.update |
| projects.regions.jobs.delete1 | dataproc.jobs.delete |
| projects.regions.jobs.getIamPolicy | dataproc.jobs.getIamPolicy |
| projects.regions.jobs.setIamPolicy | dataproc.jobs.setIamPolicy |
Notas:
Google Cloud CLI también requiere el permiso
dataproc.jobs.getpara los comandosjobs submit,jobs wait,jobs update,jobs deleteyjobs kill.La gcloud CLI también requiere el permiso
dataproc.clusters.getpara enviar trabajos. Para ver un ejemplo de cómo configurar los permisos necesarios para que un usuario ejecutegcloud dataproc jobs submiten un clúster con la IAM detallada de Managed Service para Apache Spark, consulta Envía trabajos con la IAM detallada.
Permisos obligatorios para los métodos de operaciones
| Método | Permisos necesarios |
|---|---|
| projects.regions.operations.get | dataproc.operations.get |
| projects.regions.operations.list | dataproc.operations.list |
| projects.regions.operations.cancel | dataproc.operations.cancel |
| projects.regions.operations.delete | dataproc.operations.delete |
| projects.regions.operations.getIamPolicy | dataproc.operations.getIamPolicy |
| projects.regions.operations.setIamPolicy | dataproc.operations.setIamPolicy |
Permisos necesarios para los métodos de plantillas de flujos de trabajo
| Método | Permisos necesarios |
|---|---|
| projects.regions.workflowTemplates.instantiate | dataproc.workflowTemplates.instantiate |
| projects.regions.workflowTemplates.instantiateInline | dataproc.workflowTemplates.instantiateInline |
| projects.regions.workflowTemplates.create | dataproc.workflowTemplates.create |
| projects.regions.workflowTemplates.get | dataproc.workflowTemplates.get |
| projects.regions.workflowTemplates.list | dataproc.workflowTemplates.list |
| projects.regions.workflowTemplates.update | dataproc.workflowTemplates.update |
| projects.regions.workflowTemplates.delete | dataproc.workflowTemplates.delete |
| projects.regions.workflowTemplates.getIamPolicy | dataproc.workflowTemplates.getIamPolicy |
| projects.regions.workflowTemplates.setIamPolicy | dataproc.workflowTemplates.setIamPolicy |
Notas:
Los permisos de la plantilla de flujo de trabajo son independientes de los permisos de trabajo y clúster. Un usuario sin los permisos
create clusterosubmit jobpuede crear una instancia de una plantilla de flujo de trabajo.Google Cloud CLI también requiere el permiso
dataproc.operations.getpara sondear la finalización del flujo de trabajo.El permiso
dataproc.operations.canceles necesario para cancelar un flujo de trabajo en ejecución.
Permisos obligatorios para los métodos de políticas de ajuste de escala automático
| Método | Permisos necesarios |
|---|---|
| projects.regions.autoscalingPolicies.create | dataproc.autoscalingPolicies.create |
| projects.regions.autoscalingPolicies.get | dataproc.autoscalingPolicies.get |
| projects.regions.autoscalingPolicies.list | dataproc.autoscalingPolicies.list |
| projects.regions.autoscalingPolicies.update | dataproc.autoscalingPolicies.update |
| projects.regions.autoscalingPolicies.delete | dataproc.autoscalingPolicies.delete |
| projects.regions.autoscalingPolicies.getIamPolicy | dataproc.autoscalingPolicies.getIamPolicy |
| projects.regions.autoscalingPolicies.setIamPolicy | dataproc.autoscalingPolicies.setIamPolicy |
Notas:
dataproc.autoscalingPolicies.usees necesario para habilitar una política de ajuste de escala automático en un clúster con una solicitud del métodoclusters.patch.
Permisos obligatorios para los métodos de grupos de nodos
| Método | Permisos necesarios |
|---|---|
| projects.regions.nodeGroups.create | dataproc.nodeGroups.create |
| projects.regions.nodeGroups.get | dataproc.nodeGroups.get |
| projects.regions.nodeGroups.resize | dataproc.nodeGroups.update |
Roles de Managed Service para Apache Spark
Los roles de IAM de Managed Service para Apache Spark
son un paquete de uno o más permisos.
Otorga roles a los usuarios o grupos para permitirles realizar acciones en los
recursos de Managed Service para Apache Spark en un proyecto. Por ejemplo,
el rol de visualizador de Managed Service para Apache Spark contiene
los permisos get y list, que permiten que un usuario obtenga y enumere
los clústeres, los trabajos y las operaciones de Managed Service para Apache Spark en un proyecto.
En la siguiente tabla, se enumeran los roles que contienen los permisos necesarios para crear y administrar clústeres de Managed Service para Apache Spark.
| Otorgar rol a | Funciones |
|---|---|
| Usuario | Otorga a los usuarios los siguientes roles:
|
| Cuenta de servicio | Otorga el rol de trabajador de Dataproc a la cuenta de servicio de VM de Managed Service para Apache Spark. |
Ten en cuenta lo siguiente:
Es posible que debas otorgar a la cuenta de servicio de la VM de Managed Service para Apache Spark roles predefinidos o personalizados adicionales que contengan los permisos necesarios para otras operaciones, como leer y escribir datos desde y hacia Cloud Storage, BigQuery, Cloud Logging y otros recursos de Google Cloud .
En algunos proyectos, es posible que a la cuenta de servicio de VM de Managed Service para Apache Spark se le haya otorgado automáticamente el rol de editor del proyecto, que incluye los permisos del rol de trabajador de Dataproc y permisos adicionales que no se necesitan para las operaciones del plano de datos de Managed Service para Apache Spark. Para seguir el principio de seguridad de privilegio mínimo, reemplaza el rol de editor por el de trabajador de Dataproc (consulta Visualiza los roles de la cuenta de servicio de la VM).
¿Necesitas otorgar roles?
Según la política de la organización, es posible que ya se haya otorgado un rol obligatorio.
Verifica los roles otorgados a los usuarios
Para ver si se le otorgó un rol a un usuario, sigue las instrucciones que se indican en Administra el acceso a proyectos, carpetas y organizaciones > Consulta el acceso actual.
Verifica los roles otorgados a las cuentas de servicio
Para ver si se otorgó un rol a una cuenta de servicio, consulta Visualiza y administra los roles de la cuenta de servicio de IAM.
Verifica los roles otorgados en una cuenta de servicio
Para ver si se le otorgó un rol a un usuario en una cuenta de servicio, sigue las instrucciones que se indican en Administra el acceso a las cuentas de servicio > Consulta el acceso actual.
Busca roles y permisos de Managed Service para Apache Spark
Puedes usar la siguiente sección para buscar roles y permisos de Managed Service para Apache Spark.
| Role | Permissions |
|---|---|
Dataproc Administrator( Full control of Dataproc resources. |
|
Dataproc Editor( Provides the permissions necessary for viewing the resources required to manage Managed Service for Apache Spark, including machine types, networks, projects, and zones. Lowest-level resources where you can grant this role:
|
|
Dataproc Viewer( Provides read-only access to Managed Service for Apache Spark resources. Lowest-level resources where you can grant this role:
|
|
Dataproc Hub Agent( Allows management of Dataproc resources. Intended for service accounts running Dataproc Hub instances. |
|
Dataproc Serverless Editor( Permissions needed to run serverless sessions and batches as a user |
|
Dataproc Serverless Node.( Node access to Dataproc Serverless sessions and batches. Intended for service accounts. |
|
Dataproc Serverless Viewer( Permissions needed to view serverless sessions and batches |
|
Dataproc Worker( Provides worker access to Managed Service for Apache Spark resources. Intended for service accounts. |
|
Service agent roles
Service agent roles should only be granted to service agents.
| Role | Permissions |
|---|---|
Dataproc Service Agent( Gives Dataproc Service Account access to service accounts, compute resources, storage resources, and kubernetes resources. Includes access to service accounts. |
|
Notas:
- Los permisos de
computeson necesarios o recomendados para crear y ver clústeres de Managed Service para Apache Spark cuando se usa la consola de Google Cloud o gcloud CLI de Google Cloud CLI. - Para permitir que un usuario suba archivos, otorga la función
Storage Object Creator. Para permitir que un usuario vea el resultado del trabajo, otorga la funciónStorage Object Viewer. - Un usuario debe tener el permiso
monitoring.timeSeries.listpara ver los gráficos en la consola de Google Cloud →Managed Service para Apache Spark→Detalles del clúster pestaña Resumen. - Un usuario debe tener el permiso
compute.instances.listpara ver el estado de la instancia y el menú de SSH de la instancia principal en la pestaña Instancias de VM de la consola deGoogle Cloud →Managed Service para Apache Spark→Detalles del clúster. Para obtener información sobre los roles de Compute Engine, consulta Compute Engine > Roles de IAM disponibles. - Para crear un clúster con una cuenta de servicio especificada por el usuario, la cuenta de servicio especificada
debe tener todos los permisos otorgados por el
rol
Dataproc Worker, que incluye el acceso a los buckets de etapa de pruebas y temporales de Managed Service para Apache Spark. Es posible que se requieran funciones adicionales según las características configuradas. Consulta Crea un clúster con una cuenta de servicio de VM personalizada para obtener más información.
Roles de proyecto
También puedes establecer permisos a nivel del proyecto mediante las funciones de Proyecto de IAM. En la siguiente tabla, se enumeran los permisos asociados con los roles de IAM del proyecto:
| Función de proyecto | Permisos |
|---|---|
| Visualizador del proyecto | Todos los permisos de proyecto para acciones de solo lectura que conservan el estado (obtener y enumerar) |
| Editor de proyecto | Todos los permisos de Lector del proyecto más todos los permisos del proyecto para acciones que modifican el estado (crear, borrar, actualizar, usar, detener y empezar) |
| Propietario del proyecto | Todos los permisos de Editor del proyecto más los permisos para administrar el control de acceso del proyecto (obtener/configurar IamPolicy) y para configurar la facturación del proyecto |
Resumen de roles de IAM y operaciones de Managed Service para Apache Spark
En la siguiente tabla, se enumeran las operaciones de Managed Service para Apache Spark asociadas con los roles de proyecto y de Managed Service para Apache Spark.
| Operación | Editor de proyecto | Visualizador del proyecto | Administrador de Managed Service para Apache Spark | Editor de Managed Service para Apache Spark | Visualizador de Managed Service para Apache Spark |
|---|---|---|---|---|---|
| Obtén o establece permisos de IAM de Managed Service para Apache Spark | No | No | Sí | No | No |
| Crear clúster | Sí | No | Sí | Sí | No |
| Mostrar clústeres | Sí | Sí | Sí | Sí | Sí |
| Obtener detalles del clúster | Sí | Sí | Sí 1, 2 | Sí 1, 2 | Sí 1, 2 |
| Actualizar clúster | Sí | No | Sí | Sí | No |
| Borrar clúster | Sí | No | Sí | Sí | No |
| Iniciar/detener clúster | Sí | No | Sí | Sí | No |
| Enviar trabajo | Sí | No | Sí3 | Sí3 | No |
| Mostrar trabajos | Sí | Sí | Sí | Sí | Sí |
| Obtener detalles del trabajo | Sí | Sí | Sí4 | Sí4 | Sí4 |
| Cancelar trabajo | Sí | No | Sí | Sí | No |
| Borrar trabajos | Sí | No | Sí | Sí | No |
| Mostrar lista de operaciones | Sí | Sí | Sí | Sí | Sí |
| Obtener detalles de la operación | Sí | Sí | Sí | Sí | Sí |
| Borrar operación | Sí | No | Sí | Sí | No |
Notas:
- El gráfico de rendimiento no está disponible, a menos que el usuario también tenga una función con el permiso
monitoring.timeSeries.list. - La lista de VM del clúster no incluirá información del estado ni un vínculo SSH a la instancia principal, a menos que el usuario también tenga una función con el permiso
compute.instances.list. - Los trabajos que suben archivos requieren que el usuario tenga el rol
Storage Object Creatoro acceso de escritura al bucket de etapa de pruebas de Managed Service para Apache Spark. - El resultado del trabajo no está disponible, a menos que el usuario también tenga la función de Lector del objeto de Storage o se le haya otorgado acceso de lectura al bucket de etapa de pruebas para el proyecto.
Permisos de acceso de la VM de Managed Service para Apache Spark
Los permisos de acceso de las VMs y los roles de IAM funcionan en conjunto para limitar el acceso de las VM a las APIs de Google Cloud. Por ejemplo, si a las VMs del clúster solo se les otorga el
permiso https://www.googleapis.com/auth/storage-full, las aplicaciones que se ejecutan
en las VMs del clúster pueden llamar a las APIs de Cloud Storage, pero no pueden
realizar solicitudes a BigQuery, incluso si se ejecutan como una cuenta de servicio de VM
a la que se le otorgó un rol de BigQuery con permisos amplios.
Una práctica recomendada es otorgar el permiso amplio cloud-platform
(https://www.googleapis.com/auth/cloud-platform)
a las VMs y, luego, limitar el acceso de las VMs otorgando
roles de IAM específicos a la cuenta de servicio de la VM (consulta Práctica recomendada para los permisos).
Permisos predeterminados de la VM de Managed Service para Apache Spark. Si no se especifican los permisos cuando se crea un clúster (consulta gcloud dataproc cluster create --scopes), las VMs de Managed Service para Apache Spark tienen el siguiente conjunto predeterminado de permisos:
https://www.googleapis.com/auth/cloud-platform (clusters created with image version 2.1+).
https://www.googleapis.com/auth/bigquery
https://www.googleapis.com/auth/bigtable.admin.table
https://www.googleapis.com/auth/bigtable.data
https://www.googleapis.com/auth/cloud.useraccounts.readonly
https://www.googleapis.com/auth/devstorage.full_control
https://www.googleapis.com/auth/devstorage.read_write
https://www.googleapis.com/auth/logging.write
Si especificas permisos cuando creas un clúster, las VM de clúster tendrán los permisos que especifiques y el siguiente conjunto de permisos mínimos necesarios (incluso si no los especificas):
https://www.googleapis.com/auth/cloud-platform (clusters created with image version 2.1+).
https://www.googleapis.com/auth/cloud.useraccounts.readonly
https://www.googleapis.com/auth/devstorage.read_write
https://www.googleapis.com/auth/logging.write
Administración de políticas de permisos de IAM
Otorgas roles de IAM a las principales con políticas de permisos. Puedes obtener y configurar políticas de permisos con la consola de Google Cloud , la API de IAM o Google Cloud CLI.
- Para la consola de Google Cloud , consulta Control de acceso con la consola de Google Cloud .
- Para la API, consulta Control de acceso con la API.
- Para Google Cloud CLI, consulta Control de acceso con Google Cloud CLI.
¿Qué sigue?
- Obtén información sobre las principales y los roles de Managed Service para Apache Spark
- Más información sobre la IAM detallada de Managed Service para Apache Spark
- Obtén más información sobre IAM.
- Más información sobre las cuentas de servicio en Managed Service para Apache Spark