Control de acceso con la gestión de identidades y accesos
En esta página se describe cómo usar Gestión de Identidades y Accesos (IAM) para gestionar el acceso a los recursos de Colab Enterprise. Para gestionar el acceso a otros recursos de Vertex AI, consulta Control de acceso a Vertex AI con IAM.
Controlar el acceso a los cuadernos con gestión de identidades y accesos
Puedes gestionar el acceso a los cuadernos de Colab Enterprise (archivos IPYNB) a nivel de proyecto o por cuaderno.
- Para conceder acceso a los cuadernos a nivel de proyecto, asigna uno o varios roles a un principal (usuario, grupo o cuenta de servicio).
- Para conceder acceso a un cuaderno específico, asigna uno o varios roles a un principal en el cuaderno. Para obtener más información, consulta Gestionar el acceso a un cuaderno.
Ejecutar código que interactúa con otros servicios de Google Cloud
Conceder acceso a un cuaderno se limita a los permisos específicos relacionados con la interacción con el cuaderno. Por ejemplo, puedes conceder la capacidad de crear un cuaderno, escribir código en él o eliminarlo.
Para ejecutar código que interactúe con otros servicios de Google Cloud , debes usar uno de los siguientes métodos:
Ejecuta código en un tiempo de ejecución con las credenciales de usuario final habilitadas. Esto significa que tu cuaderno tiene el mismo acceso a los Google Cloud servicios que el usuario del cuaderno.
Ejecuta código que autentique y autorice tu cuaderno para interactuar con los servicios deGoogle Cloud .
Para obtener más información, consulta Ejecutar código que interactúa conGoogle Cloud.
Tipos de roles de IAM
Hay distintos tipos de roles de gestión de identidades y accesos que se pueden usar en Colab Enterprise:
Los roles predefinidos te permiten conceder un conjunto de permisos relacionados a tus recursos de Colab Enterprise a nivel de proyecto.
Los roles básicos (Propietario, Editor y Lector) proporcionan control de acceso a tus recursos de Colab Enterprise a nivel de proyecto y son comunes a todos los servicios de Google Cloud.
Los roles personalizados te permiten elegir un conjunto específico de permisos, crear tu propio rol con esos permisos y conceder el rol a los usuarios de tu organización.
Para añadir, actualizar o quitar estos roles en tu proyecto de Colab Enterprise, consulta la documentación sobre gestión del acceso a proyectos, carpetas y organizaciones.
Roles predefinidos de Colab Enterprise
Colab Enterprise forma parte de Vertex AI y sus recursos se gestionan a través de la API Vertex AI. Por lo tanto, puedes conceder a los principales 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 en operaciones comunes de Colab Enterprise, consulta Administrador de Colab Enterprise (
roles/aiplatform.colabEnterpriseAdmin
) y Usuario de Colab Enterprise (roles/aiplatform.colabEnterpriseUser
).Para obtener información sobre los roles relacionados con la gestión del tiempo de ejecución, consulta los artículos sobre el administrador del tiempo de ejecución de cuadernos (
roles/aiplatform.notebookRuntimeAdmin
) y el usuario del tiempo de ejecución de cuadernos (roles/aiplatform.notebookRuntimeUser
).Administrador de Vertex AI (
roles/aiplatform.admin
), Usuario de Vertex AI (roles/aiplatform.user
) y Lector de Vertex AI (roles/aiplatform.viewer
) también incluyen permisos de Colab Enterprise.
Role | Permissions |
---|---|
Vertex AI Administrator( Grants full access to all resources in Vertex AI |
|
Vertex AI Batch Prediction Service Agent( Vertex AI Batch Prediction Service Agent for serving batch prediction requests. |
|
Colab Enterprise Admin( Admin role of using colab enterprise. |
|
Colab Enterprise User( User role of using colab enterprise. |
|
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 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:
|
|
Vertex AI Platform Express Admin Beta( Grants admin access to Vertex AI Express |
|
Vertex AI Platform Express User Beta( Grants user access to Vertex AI Express |
|
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 Feature Store Admin( Grants full access to all resources in Vertex AI Feature Store Lowest-level resources where you can grant this role:
|
|
Vertex AI Feature Store Data Viewer( This role provides permissions to read Feature data. Lowest-level resources where you can grant this role:
|
|
Vertex AI Feature Store Data Writer( This role provides permissions to read and write Feature data. Lowest-level resources where you can grant this role:
|
|
Vertex AI Feature Store Instance Creator( Administrator of Featurestore resources, but not the child resources under Featurestores. Lowest-level resources where you can grant this role:
|
|
Vertex AI Feature Store Resource Viewer( Viewer of all resources in Vertex AI Feature Store but cannot make changes. Lowest-level resources where you can grant this role:
|
|
Vertex AI Feature Store User Beta( Deprecated. Use featurestoreAdmin instead. |
|
Vertex AI Migration Service User( Grants access to use migration service in Vertex AI |
|
Vertex AI Model Monitoring Service Agent( Gives Vertex AI Model Monitoring the permissions it needs to function. |
|
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 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 Platform Provisioned Throughput Admin Beta( Grants access to use all resources related to Vertex AI Provisioned Throughput |
|
Vertex AI RAG Data Service Agent( Vertex AI Service Agent used by Vertex RAG to access user imported data, Vertex AI, Document AI processors 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. |
|
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 Tensorboard Web App User Beta( Grants access to the Vertex AI TensorBoard web app. |
|
Vertex AI Tuning Service Agent( Vertex AI Service Agent used for tuning in user project. |
|
Vertex AI User( Grants access to use all resource in Vertex AI |
|
Vertex AI Viewer( Grants access to view all resource in Vertex AI |
|
Roles básicos
Los roles básicos Google Cloud anteriores son comunes a todos los servicios Google Cloud . Estos roles son Propietario, Editor y Lector.
Los roles básicos proporcionan permisos en Google Cloud, no solo para Colab Enterprise. Por este motivo, le recomendamos que utilice los roles de Colab Enterprise siempre que sea posible.
Roles personalizados
Si los roles de gestión de identidades y accesos predefinidos de Colab Enterprise no se ajustan a tus necesidades, puedes definir roles personalizados. Los roles personalizados te permiten elegir un conjunto específico de permisos, crear tu propio rol con esos permisos y conceder el rol a los usuarios de tu organización. Para obtener más información, consulta el artículo Conocer los roles personalizados de gestión de identidades y accesos.
Agentes de servicio de 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 asigna un rol predefinido para tu proyecto.
En la siguiente tabla se indican los agentes de servicio de Colab Enterprise, sus direcciones de correo electrónico y sus respectivos roles:
Nombre | Se usa en: | 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 Vertex AI Colab | Concede 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 cuadernos de Vertex AI | Ejecutar recursos gestionados por cuadernos en el proyecto de 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 asignar esos roles automáticamente para garantizar que el servicio funcione sin interrupciones. Para desactivar el servicio Colab Enterprise, debes desactivar las APIs correspondientes en lugar de quitar roles.
Siguientes pasos
Concede acceso a un principal a un cuaderno de Colab Enterprise.
Consulta cómo crear y gestionar roles de gestión de identidades y accesos personalizados.