Control de acceso con IAM
En esta página, se describe cómo usar Identity and Access Management (IAM) para administrar el acceso a los recursos de Colab Enterprise. Para administrar el acceso a otros recursos de Vertex AI, consulta Control de acceso a Vertex AI con IAM.
Controla el acceso a los notebooks con IAM
Puedes administrar el acceso a los notebooks de Colab Enterprise (archivos IPYNB) a nivel de proyecto o por notebook.
- Para otorgar acceso a los notebooks a nivel de proyecto, asigna uno o más roles a una principal (usuario, grupo o cuenta de servicio).
- Para otorgar acceso a un notebook específico, asigna uno o más roles a una entidad en el notebook. Para obtener más información, consulta Administra el acceso a un notebook.
Ejecuta código que interactúa con otros Google Cloud servicios
El otorgamiento de acceso a un notebook se limita a los permisos específicos relacionados con la interacción con el notebook. Por ejemplo, puedes otorgar la capacidad de crear un notebook, escribir código en él o borrarlo.
Para ejecutar código que interactúe con otros Google Cloud servicios, debes usar uno de los siguientes métodos:
Ejecuta código en un entorno de ejecución con credenciales de usuario final habilitadas. Esto significa tu notebook tiene el mismo acceso a los Google Cloud servicios que el usuario del notebook.
Ejecuta código que autentique y autorice tu notebook para interactuar con Google Cloud los servicios.
Para obtener más información, consulta Ejecuta código que interactúa con Google Cloud.
Tipos de roles de IAM
Hay diferentes tipos de roles de IAM que se pueden usar en Colab Enterprise:
Los roles predefinidos te permiten otorgar un conjunto de permisos relacionados a tus recursos de Colab Enterprise en el nivel del proyecto.
Los roles básicos (propietario, editor y visualizador) proporcionan control de acceso a tus recursos de Colab Enterprise en el nivel del proyecto y son comunes para todos los Google Cloud servicios.
Los roles personalizados te permiten elegir un conjunto de permisos específico, crear tu propio rol con esos permisos y otorgarlo a los usuarios en tu organización.
Para agregar, actualizar o quitar estos roles en tu proyecto de Colab Enterprise, consulta la documentación sobre cómo administrar el acceso a proyectos, carpetas y organizaciones.
Roles predefinidos para Colab Enterprise
Colab Enterprise forma parte de Vertex AI, y los recursos de Colab Enterprise se administran a través de la API de Vertex AI. Por lo tanto, puedes otorgar a las entidades acceso a los recursos de Colab Enterprise a través de los roles de Vertex AI.
En la siguiente tabla, se incluyen todos los roles predefinidos de Vertex AI.
Para usar roles predefinidos para operaciones comunes de Colab Enterprise, consulta Administrador de Colab Enterprise (
roles/aiplatform.colabEnterpriseAdmin) y Usuario de Colab Enterprise (roles/aiplatform.colabEnterpriseUser).Para los roles relacionados con la administración del entorno de ejecución, consulta Administrador del entorno de ejecución del notebook (
roles/aiplatform.notebookRuntimeAdmin) y Usuario del entorno de ejecución del notebook (roles/aiplatform.notebookRuntimeUser).El administrador de Vertex AI (
roles/aiplatform.admin), el usuario de Vertex AI (roles/aiplatform.user) y el visualizador de Vertex AI (roles/aiplatform.viewer) también incluyen permisos de Colab Enterprise.
| Role | Permissions |
|---|---|
Agent Platform Administrator( Grants full access to all resources in Agent Platform. |
|
Aiplatform Editor( Editor role for aiplatform |
|
Agent Platform Express User Beta( Grants user access to Agent Platform Express. |
|
Agent Platform User( Grants access to use all resource in Agent Platform. |
|
Agent Platform Viewer( Grants access to view all resource in Agent Platform. |
|
Colab Enterprise Admin( Admin role of using colab enterprise. |
|
Colab Enterprise User( User role of using colab enterprise. |
|
Agent Platform Feature Store EntityType owner( Provides full access to all permissions for a particular entity type resource. Lowest-level resources where you can grant this role:
|
|
Agent Platform Express Admin Beta( Grants admin access to Agent Platform Express. |
|
Agent Platform Feature Store Admin( Grants full access to all resources in Agent Platform Feature Store. Lowest-level resources where you can grant this role:
|
|
Agent Platform Feature Store Data Viewer( This role provides permissions to read Feature data. Lowest-level resources where you can grant this role:
|
|
Agent Platform Feature Store Data Writer( This role provides permissions to read and write Feature data. Lowest-level resources where you can grant this role:
|
|
Agent Platform Feature Store Instance Creator( Administrator of Featurestore resources, but not the child resources under Featurestores. Lowest-level resources where you can grant this role:
|
|
Agent Platform Feature Store Resource Viewer( Viewer of all resources in Agent Platform Feature Store but cannot make changes. Lowest-level resources where you can grant this role:
|
|
Agent Platform Feature Store User Beta( Deprecated. Use featurestoreAdmin instead. |
|
Agent Platform Memory Bank Editor Role( Grants edit access to Agent Platform Memory Bank. |
|
Agent Platform Memory Bank User Role( Grants full user access to Agent Platform Memory Bank. |
|
Agent Platform Memory Bank Viewer Role( Grants viewer access to Agent Platform Memory Bank. |
|
Agent Platform Migration Service User( Grants access to use migration service in Agent Platform |
|
Notebook Executor User Beta( Grants users full access to schedules and notebook execution jobs. |
|
Notebook Runtime Admin( Grants full access to all runtime templates and runtimes in Notebook Service. |
|
Notebook Runtime User( Grants users permissions to create runtime resources using a runtime template and manage the runtime resources they created. |
|
Vertex AI Platform Provisioned Throughput Admin Beta( Grants access to use all resources related to Vertex AI Provisioned Throughput |
|
Vertex AI Platform Publisher Provisioned Throughput Admin Beta( Grants Publisher access to use all resources related to Vertex AI Provisioned Throughput Orders |
|
Vertex AI Platform Publisher Provisioned Throughput Viewer Beta( Grants Publisher access to view all resources related to Vertex AI Provisioned Throughput Orders |
|
Agent Platform Sessions Editor Role( Grants edit access to Agent Platform Sessions. |
|
Agent Platform Sessions User Role( Grants full user access to Agent Platform Sessions. |
|
Agent Platform Sessions Viewer Role( Grants viewer access to Agent Platform Sessions |
|
Agent Platform Tensorboard Web App User Beta( Grants access to the Vertex AI TensorBoard web app. |
|
Service agent roles
Service agent roles should only be granted to service agents.
| Role | Permissions |
|---|---|
Vertex AI Agent Sandbox Service Agent( Vertex AI Service Agent used to access Agent Sandbox managed resources in consumer project with restricted permissions. |
|
Vertex AI Batch Prediction Service Agent( Vertex AI Batch Prediction Service Agent for serving batch prediction requests. |
|
Vertex AI Colab Service Agent( Gives Vertex AI Colab the proper permissions to function. |
|
Vertex AI Custom Code Service Agent( Gives Vertex AI Custom Code the proper permissions. |
|
Vertex AI Extension Custom Code Service Agent( Gives Vertex AI Extension that executes custom code the permissions it needs to function. |
|
Vertex AI Extension Service Agent( Gives Vertex AI Extension the permissions it needs to function. |
|
Vertex AI Model Monitoring Service Agent( Gives Vertex AI Model Monitoring the permissions it needs to function. |
|
Vertex AI Notebook Service Agent( Vertex AI Service Agent used to run Notebook managed resources in user project with restricted permissions. |
|
Vertex AI Online Prediction Service Agent( Gives Vertex AI Online Prediction the permissions it needs to function. |
|
Vertex AI RAG Data Service Agent( Vertex AI Service Agent used by Vertex RAG to access user imported data, Vertex AI, Document AI processors, and Vector Search in the project |
|
Vertex AI Rapid Eval Service Agent( Vertex AI Service Agent used by GenAI Rapid Evaluation Service to access publisher model endpoints in the user project |
|
Vertex AI Reasoning Engine Service Agent( Gives Vertex AI Reasoning Engine the proper permissions to function. The aiplatform.reasoningEngines.create IAM permission implies read access to the GCS objects of the consumer project through this service agent. |
|
Vertex AI Service Agent( Gives Vertex AI the permissions it needs to function. |
|
Vertex AI Telemetry Service Agent( Allows Vertex AI Telemetry Service Agent to access telemetry data. |
|
Vertex AI Tuning Service Agent( Vertex AI Service Agent used for tuning in user project. |
|
Funciones básicas
Las funciones básicas anteriores son comunes a todos los servicios. Google CloudGoogle Cloud Son las funciones de propietario, editor y visualizador.
Las funciones básicas proporcionan permisos en Google Cloud, no solo para Colab Enterprise. Por este motivo, deberías usar las funciones de Colab Enterprise siempre que sea posible.
Funciones personalizadas
Si los roles predefinidos de IAM para Colab Enterprise no satisfacen tus necesidades, puedes definir roles personalizados. Los roles personalizados te permiten elegir un conjunto de permisos específico, crear tu propio rol con esos permisos y otorgarlo a los usuarios en tu organización. Para obtener más información, consulta Comprende los roles personalizados de IAM.
Agentes de servicio para Colab Enterprise
Colab Enterprise crea y usa automáticamente agentes de servicio para acceder a los recursos en tu nombre. Cuando se crea un agente de servicio, se le otorga un rol predefinido para tu proyecto.
En la siguiente tabla, se enumeran los agentes de servicio de Colab Enterprise, sus direcciones de correo electrónico y sus respectivos roles:
| Nombre | Se usa para | Dirección de correo electrónico | Rol |
|---|---|---|---|
| Agente de servicio de Vertex AI | Funciones de Vertex AI | service-PROJECT_NUMBER@gcp-sa-aiplatform.iam.gserviceaccount.com |
roles/aiplatform.serviceAgent |
| Agente de servicio de Colab de Vertex AI | Otorga a Colab Enterprise los permisos adecuados para funcionar | service-PROJECT_NUMBER@gcp-sa-vertex-nb.iam.gserviceaccount.com |
roles/aiplatform.colabServiceAgent |
| Agente de servicio de notebook de Vertex AI | Ejecuta recursos administrados por notebooks en el proyecto del usuario con permisos restringidos | service-PROJECT_NUMBER@gcp-sa-aiplatform-vm.iam.gserviceaccount.com |
roles/aiplatform.notebookServiceAgent |
Si quitas los roles predeterminados de los agentes de servicio de Colab Enterprise, Colab Enterprise puede volver a asignarlos automáticamente para garantizar la funcionalidad ininterrumpida del servicio. Para desactivar el servicio de Colab Enterprise, debes desactivar las APIs pertinentes en lugar de quitar roles.
Consideraciones de seguridad para los permisos de Colab Enterprise
Cuando un usuario crea un notebook de Colab Enterprise, se le otorga automáticamente
el
rol de propietario del código (roles/dataform.codeOwner)
en ese notebook. Este otorgamiento de roles a nivel de recursos es independiente de cualquier rol de IAM a nivel de proyecto.
IAM organiza las políticas de forma jerárquica:
- Un usuario puede tener un rol en la política de IAM del proyecto, que se propaga automáticamente a todos los recursos del proyecto.
- Un usuario también puede tener un rol en una política de recursos específica, como un notebook individual.
Un usuario tiene acceso a un recurso si tiene un rol en la política de recursos o en cualquiera de sus políticas superiores.
Para revocar por completo el acceso de un usuario, los administradores pueden realizar cualquiera de las siguientes acciones:
- Quita los roles del usuario de cada notebook individual. Para obtener más información, consulta Quita el acceso a nivel de recursos de un notebook.
- Crea una política de denegación de IAM para revocar todos los permisos del usuario en todos los recursos del proyecto.
¿Qué sigue?
Otorga a una entidad acceso a un notebook de Colab Enterprise.
Obtén más información sobre cómo crear y administrar roles personalizados de IAM.
Obtén más información sobre los agentes de servicio.