Controle de acesso com o IAM
Nesta página, descrevemos como usar o Identity and Access Management (IAM) para gerenciar o acesso aos recursos do Colab Enterprise. Para gerenciar o acesso a outros recursos da Gemini Enterprise Agent Platform, consulte Controle de acesso da Agent Platform com o IAM.
Controlar o acesso a notebooks com o IAM
É possível gerenciar o acesso aos notebooks do Colab Enterprise (arquivos IPYNB) no nível do projeto ou por notebook.
- Para conceder acesso a notebooks no nível do projeto, atribua um ou mais papéis a um principal (usuário, grupo ou conta de serviço).
- Para conceder acesso a um notebook específico, atribua um ou mais papéis a um principal no notebook. Para saber mais, consulte Gerenciar o acesso a um notebook.
Executar código que interage com outros serviços do Google Cloud
A concessão de acesso a um notebook é limitada às permissões específicas relacionadas à interação com o notebook. Por exemplo, é possível conceder a capacidade de criar um notebook, escrever código nele ou excluí-lo.
Para executar um código que interage com outros serviços do Google Cloud , use um dos seguintes métodos:
Execute o código em um ambiente de execução com as credenciais de usuário final ativadas. Isso significa que o notebook tem o mesmo acesso aos serviços do Google Cloud que o usuário do notebook.
Execute o código que autentica e autoriza o notebook a interagir com os serviços doGoogle Cloud .
Para saber mais, consulte Executar código que interage com o Google Cloud.
Tipos de papéis do IAM
Há diferentes tipos de papéis do IAM que podem ser usados no Colab Enterprise:
Os papéis predefinidos permitem conceder um conjunto de permissões relacionadas aos recursos do Colab Enterprise no nível do projeto.
Os papéis básicos (proprietário, editor e Leitor) fornecem controle de acesso aos recursos do Colab Enterprise no nível do projeto e são comuns a todos os serviços do Google Cloud.
Os papéis personalizados permitem escolher um conjunto específico de permissões, criar seu próprio papel com elas e concedê-lo aos usuários da organização.
Para adicionar, atualizar ou remover esses papéis do projeto do Colab Enterprise, consulte a documentação sobre como gerenciar o acesso a projetos, pastas e organizações.
Papéis predefinidos para o Colab Enterprise
O Colab Enterprise faz parte da Agent Platform, e os recursos do Colab Enterprise são gerenciados pela API Agent Platform. Portanto, é possível conceder aos principais acesso aos recursos do Colab Enterprise usando os papéis da Agent Platform.
A tabela a seguir inclui todos os papéis predefinidos da Agent Platform.
Para usar papéis predefinidos em operações comuns do Colab Enterprise, consulte Administrador do Colab Enterprise (
roles/aiplatform.colabEnterpriseAdmin) e Usuário corporativo do Colab Enterprise (roles/aiplatform.colabEnterpriseUser).Para papéis relacionados ao gerenciamento de ambientes de execução, consulte Administrador do ambiente de execução do notebook (
roles/aiplatform.notebookRuntimeAdmin) e Usuário do ambiente de execução do notebook (roles/aiplatform.notebookRuntimeUser).Os papéis de Administrador da Agent Platform (
roles/aiplatform.admin), Usuário da Agent Platform (roles/aiplatform.user) e Leitor da Agent Platform (roles/aiplatform.viewer) também incluem permissões do 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. |
|
Agent Platform Agents Admin Role Beta( Grants full administrative access to Agent Platform agents, including reading and managing their memories and their access control policies. |
|
Agent Platform Agents Creator Role Beta( Grants access to create and discover Agent Platform agents and their auth providers, and to create and list collaborative projects. |
|
Agent Platform Agents User Role Beta( Grants access to view agents and to create, update, cancel, and delete their tasks. |
|
Agent Platform Agents Viewer Role Beta( Grants read-only access to Agent Platform agents. |
|
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. The aiplatform.customJobs.create IAM permission is highly privileged. Through Vertex AI Custom Training jobs, it effectively grants editor-level access to other services activated for the consumer project, such as GCS and BigQuery. |
|
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. |
|
Papéis básicos
Os papéis básicos mais antigos do Google Cloud são comuns a todos os serviços do Google Cloud . Esses papéis são de Proprietário, Editor e Visualizador.
Os papéis básicos fornecem permissões em todo o Google Cloud, não apenas no Colab Enterprise. Por esse motivo, use os papéis do Colab Enterprise sempre que possível.
Papéis personalizados
Se os papéis predefinidos do IAM para o Colab Enterprise não atenderem às suas necessidades, é possível definir funções personalizadas. Os papéis personalizados permitem escolher um conjunto específico de permissões, criar seu próprio papel com elas e concedê-lo aos usuários da organização. Para mais informações, consulte Noções básicas sobre papéis personalizados do IAM.
Agentes de serviço do Colab Enterprise
O Colab Enterprise cria e usa automaticamente agentes de serviço para acessar recursos em seu nome. Quando um agente de serviço é criado, ele recebe um papel predefinido para o projeto.
A tabela a seguir lista os agentes de serviço do Colab Enterprise, os endereços de e-mail e os respectivos papéis:
| Nome | Usado para | Endereço de e-mail | Papel |
|---|---|---|---|
| Agente de serviço da Vertex AI | Recursos da Agent Platform | service-PROJECT_NUMBER@gcp-sa-aiplatform. |
roles/aiplatform.serviceAgent |
| Agente de serviço da Vertex AI Colab | Concede ao Colab Enterprise as permissões necessárias para funcionar. | service-PROJECT_NUMBER@gcp-sa-vertex-nb. |
roles/aiplatform.colabServiceAgent |
| Agente de serviço da Vertex AI para Notebook | Executar recursos gerenciados por notebook no projeto do usuário com permissões restritas | service-PROJECT_NUMBER@gcp-sa-aiplatform-vm. |
roles/aiplatform.notebookServiceAgent |
Se você remover os papéis padrão dos agentes de serviço do Colab Enterprise, o Colab Enterprise poderá reatribuir automaticamente esses papéis para garantir a funcionalidade ininterrupta do serviço. Para desativar o serviço do Colab Enterprise, desative as APIs relevantes em vez de remover os papéis.
Considerações de segurança para permissões do Colab Enterprise
Quando um usuário cria um notebook do Colab Enterprise, ele recebe automaticamente o papel de Proprietário do código (roles/dataform.codeOwner) nesse notebook. Essa concessão de papel no nível do recurso é separada de qualquer
papel do IAM para envolvidos no projeto.
O IAM organiza as políticas de maneira hierárquica:
- Um usuário pode ter um papel na política do IAM do projeto, que é propagado automaticamente para todos os recursos do projeto.
- Um usuário também pode ter um papel em uma política de recurso específica, como um notebook individual.
Um usuário terá acesso a um recurso se tiver um papel na política do recurso ou em qualquer uma das políticas pai.
Para revogar totalmente o acesso de um usuário, os administradores podem fazer o seguinte:
- Remova os papéis do usuário de cada notebook individual. Para saber mais, consulte Remover o acesso no nível do recurso de um notebook.
- Crie uma política de negação do IAM para revogar todas as permissões do usuário em todos os recursos do projeto.
Como os notebooks no Colab Enterprise são armazenados no Dataform, considere as seguintes implicações de segurança para usuários com acesso a esses notebooks:
- A visibilidade dos notebooks é controlada pelas permissões do Dataform no nível do projeto. Os usuários com a
permissão
dataform.repositories.list, que está incluída nos papéis padrão do Colab Enterprise, como Usuário do Colab Enterprise (roles/aiplatform.colabEnterpriseUser) e Administrador do Colab Enterprise (roles/aiplatform.colabEnterpriseAdmin), podem ver todos os notebooks no projetoGoogle Cloud , independentemente de terem sido criados por eles ou compartilhados com eles. Para restringir a visibilidade, crie funções personalizadas que excluam a permissãodataform.repositories.list. - Os papéis padrão do Colab Enterprise, como
roles/aiplatform.colabEnterpriseUsereroles/aiplatform.colabEnterpriseAdmin, também incluemdataform.repositories.create, e os criadores recebem acesso de proprietário ou acesso de admin no nível do recurso nos notebooks e repositórios que criam. Isso permite que os usuários criem ou atualizem repositórios do Dataform no projetoGoogle Cloud que fazem referência a recursos compartilhados com o agente de serviço do Dataform, incluindo secrets do Secret Manager, links de repositório Git do Developer Connect e buckets do Cloud Storage usados para snapshots de repositório, sem exigir permissões diretas do IAM nesses recursos. Para proteger suas credenciais e buckets de armazenamento, restrinja as permissões de criação, edição e compilação do repositório do Dataform a usuários confiáveis, apliqueconstraints/dataform.restrictGitRemotese limite as permissões do agente de serviço do Dataform apenas aos recursos necessários. Para mais informações, consulte Acesso compartilhado a recursos pelo agente de serviço do Dataform e Acesso a secrets durante a instalação do pacote.
Para mais informações, consulte Considerações de segurança para permissões do Dataform.