Controllo dell'accesso con IAM
Questa pagina descrive come utilizzare Identity and Access Management (IAM) per gestire l'accesso alle risorse di Colab Enterprise. Per gestire l'accesso ad altre risorse di Vertex AI, consulta Controllo dell'accesso di Vertex AI con IAM.
Controllare l'accesso ai notebook con IAM
Puoi gestire l'accesso ai notebook Colab Enterprise (file IPYNB) a livello di progetto o per notebook.
- Per concedere l'accesso ai notebook a livello di progetto, assegna uno o più ruoli a un'entità (utente, gruppo o service account).
- Per concedere l'accesso a un notebook specifico, assegna uno o più ruoli a un'entità nel notebook. Per scoprire di più, consulta Gestire l'accesso a un notebook.
Eseguire codice che interagisce con altri Google Cloud servizi
La concessione dell'accesso a un notebook è limitata alle autorizzazioni specifiche relative all'interazione con il notebook. Ad esempio, puoi concedere la possibilità di creare un notebook, scriverci codice o eliminarlo.
Per eseguire codice che interagisce con altri Google Cloud servizi, devi utilizzare uno dei seguenti metodi:
Esegui il codice in un runtime con le credenziali dell'utente finale abilitate. Ciò significa che il notebook ha lo stesso accesso ai servizi dell'utente del notebook. Google Cloud
Esegui il codice che autentica e autorizza il notebook a interagire con Google Cloud i servizi.
Per scoprire di più, consulta Eseguire codice che interagisce con Google Cloud.
Tipi di ruoli IAM
Esistono diversi tipi di ruoli IAM che possono essere utilizzati in Colab Enterprise:
I ruoli predefiniti consentono di concedere un insieme di autorizzazioni correlate alle risorse di Colab Enterprise a livello di progetto.
I ruoli di base (Proprietario, Editor e Visualizzatore) forniscono il controllo dell'accesso alle risorse di Colab Enterprise a livello di progetto e sono comuni a tutti i Google Cloud servizi.
I ruoli personalizzati consentono di scegliere un insieme specifico di autorizzazioni, creare un ruolo con queste autorizzazioni e concederlo agli utenti della tua organizzazione.
Per aggiungere, aggiornare o rimuovere questi ruoli nel progetto Colab Enterprise, consulta la documentazione sulla gestione dell'accesso a progetti, cartelle e organizzazioni.
Ruoli predefiniti per Colab Enterprise
Colab Enterprise fa parte di Vertex AI e le risorse di Colab Enterprise vengono gestite tramite l'API Vertex AI. Pertanto, puoi concedere alle entità l'accesso alle risorse di Colab Enterprise tramite i ruoli di Vertex AI.
La tabella seguente include tutti i ruoli predefiniti di Vertex AI.
Per utilizzare i ruoli predefiniti per le operazioni comuni di Colab Enterprise, consulta Colab Enterprise Admin (
roles/aiplatform.colabEnterpriseAdmin) e Colab Enterprise User (roles/aiplatform.colabEnterpriseUser).Per i ruoli relativi alla gestione del runtime, consulta Notebook Runtime Admin (
roles/aiplatform.notebookRuntimeAdmin) e Notebook Runtime User (roles/aiplatform.notebookRuntimeUser).Vertex AI Administrator (
roles/aiplatform.admin), Vertex AI User (roles/aiplatform.user) e Vertex AI Viewer (roles/aiplatform.viewer) includono anche le autorizzazioni di 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. |
|
Ruoli di base
I ruoli di base precedenti Google Cloud sono comuni a tutti i Google Cloud servizi. Questi ruoli sono Proprietario, Editor e Visualizzatore.
I ruoli di base forniscono autorizzazioni per tutti i servizi Google Cloud, non solo per Colab Enterprise. Per questo motivo, dovresti utilizzare i ruoli di Colab Enterprise, se possibile.
Ruoli personalizzati
Se i ruoli IAM predefiniti per Colab Enterprise non soddisfano le tue esigenze, puoi definire ruoli personalizzati. I ruoli personalizzati consentono di scegliere un insieme specifico di autorizzazioni, creare un ruolo con queste autorizzazioni e concederlo agli utenti della tua organizzazione. Per scoprire di più, consulta Informazioni sui ruoli IAM personalizzati.
Service agent per Colab Enterprise
Colab Enterprise crea e utilizza automaticamente i service agent per accedere alle risorse per tuo conto. Quando viene creato un service agent, gli viene concesso un ruolo predefinito per il progetto.
La tabella seguente elenca i service agent di Colab Enterprise, i relativi indirizzi email e i rispettivi ruoli:
| Nome | Utilizzato per | Indirizzo email | Ruolo |
|---|---|---|---|
| Vertex AI Service Agent | Funzionalità di Vertex AI | service-PROJECT_NUMBER@gcp-sa-aiplatform.iam.gserviceaccount.com |
roles/aiplatform.serviceAgent |
| Vertex AI Colab Service Agent | Concede a Colab Enterprise le autorizzazioni appropriate per funzionare | service-PROJECT_NUMBER@gcp-sa-vertex-nb.iam.gserviceaccount.com |
roles/aiplatform.colabServiceAgent |
| Vertex AI Notebook Service Agent | Esegui le risorse gestite dai notebook nel progetto utente con autorizzazioni limitate | service-PROJECT_NUMBER@gcp-sa-aiplatform-vm.iam.gserviceaccount.com |
roles/aiplatform.notebookServiceAgent |
Se rimuovi i ruoli predefiniti dei service agent di Colab Enterprise, Colab Enterprise può riassegnarli automaticamente per garantire la funzionalità del servizio senza interruzioni. Per disattivare il servizio Colab Enterprise, devi disattivare le API pertinenti anziché rimuovere i ruoli.
Considerazioni sulla sicurezza per le autorizzazioni di Colab Enterprise
Quando un utente crea un notebook Colab Enterprise, gli viene concesso automaticamente
il
ruolo Proprietario del codice (roles/dataform.codeOwner)
nel notebook. Questa concessione di ruoli a livello di risorsa è separata da qualsiasi ruolo IAM a livello di progetto.
IAM organizza le policy in modo gerarchico:
- Un utente può avere un ruolo nella policy IAM del progetto, che viene propagata automaticamente a tutte le risorse del progetto.
- Un utente può anche avere un ruolo in una policy di risorse specifica, ad esempio un singolo notebook.
Un utente ha accesso a una risorsa se ha un ruolo nella policy della risorsa o in una delle relative policy principali.
Per revocare completamente l'accesso di un utente, gli amministratori possono eseguire una delle seguenti operazioni:
- Rimuovi i ruoli dell'utente da ogni singolo notebook. Per scoprire di più, consulta Rimuovere l'accesso a livello di risorsa da un notebook.
- Crea una policy di negazione IAM per revocare tutte le autorizzazioni dell'utente su tutte le risorse del progetto.
Passaggi successivi
Concedi a un'entità l'accesso a un notebook Colab Enterprise.
Scopri come creare e gestire ruoli IAM personalizzati.
Scopri di più sui service agent