Contrôle des accès avec IAM
Cette page explique comment utiliser Identity and Access Management (IAM) pour gérer l'accès aux ressources Colab Enterprise. Pour gérer l'accès à d'autres ressources Gemini Enterprise Agent Platform, consultez Contrôle des accès Agent Platform avec IAM.
Contrôler l'accès aux notebooks avec IAM
Vous pouvez gérer l'accès aux notebooks Colab Enterprise (fichiers IPYNB) au niveau du projet ou par notebook.
- Pour accorder l'accès aux notebooks au niveau du projet, attribuez un ou plusieurs rôles à un compte principal (utilisateur, groupe ou compte de service).
- Pour accorder l'accès à un notebook spécifique, attribuez un ou plusieurs rôles à un compte principal sur le notebook. Pour en savoir plus, consultez Gérer l'accès à un notebook.
Exécuter du code qui interagit avec d'autres services Google Cloud
L'octroi de l'accès à un notebook est limité aux autorisations spécifiques liées à l'interaction avec le notebook. Par exemple, vous pouvez accorder la possibilité de créer un notebook, d'y écrire du code ou de le supprimer.
Pour exécuter du code qui interagit avec d'autres services Google Cloud , vous devez utiliser l'une des méthodes suivantes :
Exécutez le code dans un environnement d'exécution où les identifiants de l'utilisateur final sont activés. Cela signifie que votre notebook dispose du même accès aux services Google Cloud que l'utilisateur de votre notebook.
Exécutez du code qui authentifie et autorise votre notebook à interagir avec les servicesGoogle Cloud .
Pour en savoir plus, consultez Exécuter du code qui interagit avecGoogle Cloud.
Types de rôles IAM
Vous pouvez utiliser différents types de rôles IAM dans Colab Enterprise :
Les rôles prédéfinis vous permettent d'accorder à vos ressources Colab Enterprise un ensemble d'autorisations associées au niveau du projet.
Les rôles de base (Propriétaire, Éditeur et Lecteur) permettent le contrôle des accès à vos ressources Colab Enterprise au niveau du projet et sont communs à tous les services Google Cloud.
Les rôles personnalisés vous permettent de choisir un ensemble d'autorisations spécifique, de créer un rôle disposant de ces autorisations et d'attribuer ce dernier à des utilisateurs de votre organisation.
Pour ajouter, mettre à jour ou supprimer ces rôles dans votre projet Colab Enterprise, consultez la documentation expliquant comment gérer l'accès aux projets, aux dossiers et aux organisations.
Rôles prédéfinis pour Colab Enterprise
Colab Enterprise fait partie d'Agent Platform, et les ressources Colab Enterprise sont gérées via l'API Agent Platform. Par conséquent, vous pouvez accorder aux comptes principaux l'accès aux ressources Colab Enterprise via les rôles Agent Platform.
Le tableau suivant inclut tous les rôles prédéfinis d'Agent Platform.
Pour utiliser des rôles prédéfinis pour les opérations Colab Enterprise courantes, consultez Administrateur Colab Enterprise (
roles/aiplatform.colabEnterpriseAdmin) et Utilisateur Colab Enterprise (roles/aiplatform.colabEnterpriseUser).Pour connaître les rôles liés à la gestion de l'environnement d'exécution, consultez Administrateur de l'environnement d'exécution de notebook (
roles/aiplatform.notebookRuntimeAdmin) et Utilisateur de l'environnement d'exécution de notebook (roles/aiplatform.notebookRuntimeUser).Administrateur Agent Platform (
roles/aiplatform.admin), Utilisateur Agent Platform (roles/aiplatform.user) et Lecteur Agent Platform (roles/aiplatform.viewer) incluent également les autorisations 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. |
|
Rôles de base
Les rôles de base Google Cloudplus anciens sont communs à tous les services Google Cloud . Il s'agit des rôles Propriétaire, Éditeur et Lecteur.
Les rôles de base fournissent des autorisations pour Google Cloud, et pas uniquement pour Colab Enterprise. Pour cette raison, nous vous recommandons d'utiliser les rôles Colab Enterprise chaque fois que cela est possible.
Rôles personnalisés
Si les rôles IAM prédéfinis pour Colab Enterprise ne répondent pas à vos besoins, vous pouvez définir des rôles personnalisés. Les rôles personnalisés vous permettent de choisir un ensemble d'autorisations spécifique, de créer un rôle disposant de ces autorisations et d'attribuer ce dernier à des utilisateurs de votre organisation. Pour en savoir plus, consultez Comprendre les rôles personnalisés d'IAM.
Agents de service pour Colab Enterprise
Colab Enterprise crée et utilise automatiquement des agents de service pour accéder aux ressources en votre nom. Lorsqu'un agent de service est créé, il se voit attribuer un rôle prédéfini pour votre projet.
Le tableau suivant recense les agents de service Colab Enterprise, leurs adresses e-mail et leurs rôles respectifs :
| Nom | Utilisation | Adresse e-mail | Rôle |
|---|---|---|---|
| Agent de service Vertex AI | Fonctionnalités d'Agent Platform | service-PROJECT_NUMBER@gcp-sa-aiplatform. |
roles/aiplatform.serviceAgent |
| Agent de service Vertex AI Colab | Accorde à Colab Enterprise les autorisations nécessaires pour fonctionner. | service-PROJECT_NUMBER@gcp-sa-vertex-nb. |
roles/aiplatform.colabServiceAgent |
| Agent de service de notebook Vertex AI | Exécuter des ressources gérées par un notebook dans le projet utilisateur avec des autorisations restreintes | service-PROJECT_NUMBER@gcp-sa-aiplatform-vm. |
roles/aiplatform.notebookServiceAgent |
Si vous supprimez les rôles par défaut des agents de service Colab Enterprise, Colab Enterprise peut réattribuer automatiquement ces rôles pour assurer le fonctionnement ininterrompu du service. Pour désactiver le service Colab Enterprise, vous devez désactiver les API concernées au lieu de supprimer les rôles.
Considérations de sécurité pour les autorisations Colab Enterprise
Lorsqu'un utilisateur crée un notebook Colab Enterprise, il se voit automatiquement attribuer le rôle Propriétaire du code (roles/dataform.codeOwner) sur ce notebook. Cette attribution de rôle au niveau de la ressource est distincte de tous les rôles IAM au niveau du projet.
IAM organise les règles d'administration de manière hiérarchique :
- Un utilisateur peut avoir un rôle dans la stratégie IAM du projet, qui est automatiquement propagé à toutes les ressources du projet.
- Un utilisateur peut également avoir un rôle dans une stratégie de ressource spécifique, comme un notebook individuel.
Un utilisateur a accès à une ressource s'il dispose d'un rôle dans la stratégie de la ressource ou dans l'une de ses stratégies parentes.
Pour révoquer complètement l'accès d'un utilisateur, les administrateurs peuvent effectuer l'une des opérations suivantes :
- Supprimez les rôles de l'utilisateur de chaque notebook individuel. Pour en savoir plus, consultez Supprimer l'accès au niveau des ressources d'un notebook.
- Créez une stratégie de refus IAM pour révoquer toutes les autorisations de l'utilisateur sur toutes les ressources du projet.
Étant donné que les notebooks de Colab Enterprise sont stockés dans Dataform, vous devez tenir compte des implications de sécurité suivantes pour les utilisateurs ayant accès à ces notebooks :
- La visibilité des notebooks est régie par les autorisations Dataform au niveau du projet. Les utilisateurs disposant de l'autorisation
dataform.repositories.list, qui est incluse dans les rôles Colab Enterprise standards tels que Utilisateur Colab Enterprise (roles/aiplatform.colabEnterpriseUser) et Administrateur Colab Enterprise (roles/aiplatform.colabEnterpriseAdmin), peuvent voir tous les notebooks du projetGoogle Cloud , qu'ils les aient créés ou qu'ils aient été partagés avec eux. Pour limiter la visibilité, vous pouvez créer des rôles personnalisés qui excluent l'autorisationdataform.repositories.list. - Les rôles Colab Enterprise standards tels que
roles/aiplatform.colabEnterpriseUseretroles/aiplatform.colabEnterpriseAdminincluent égalementdataform.repositories.create, et les créateurs reçoivent un accès propriétaire ou administrateur au niveau des ressources sur les notebooks et les dépôts qu'ils créent. Cela permet aux utilisateurs de créer ou de mettre à jour des dépôts Dataform dans le projetGoogle Cloud qui font référence à des ressources partagées avec l'agent de service Dataform, y compris les secrets Secret Manager, les liens vers les dépôts Git Developer Connect et les buckets Cloud Storage utilisés pour les instantanés de dépôt, sans nécessiter d'autorisations IAM directes sur ces ressources. Pour sécuriser vos identifiants et vos buckets de stockage, limitez les autorisations de création, de modification et de compilation des dépôts Dataform aux utilisateurs de confiance, appliquezconstraints/dataform.restrictGitRemoteset limitez les autorisations de l'agent de service Dataform aux ressources nécessaires. Pour en savoir plus, consultez Accès partagé aux ressources via l'agent de service Dataform et Accès aux secrets lors de l'installation du package.
Pour en savoir plus, consultez Remarques sur la sécurité pour les autorisations Dataform.
Étapes suivantes
Accordez à un compte principal l'accès à un notebook Colab Enterprise.
Découvrez comment créer et gérer des rôles IAM personnalisés.
En savoir plus sur les agents de service