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 Vertex AI, consultez Contrôle des accès à Vertex AI 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 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'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 avec les identifiants de l'utilisateur final activés. Cela signifie que votre notebook a le même accès aux services Google Cloud que l'utilisateur du notebook.
Exécutez le 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
Différents types de rôles IAM peuvent être utilisés 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, modifier ou supprimer ces rôles dans votre projet Colab Enterprise, consultez la documentation sur la gestion de l'accès aux projets, aux dossiers et aux organisations.
Rôles prédéfinis pour Colab Enterprise
Colab Enterprise fait partie de Vertex AI, et les ressources Colab Enterprise sont gérées via l'API Vertex AI. Vous pouvez donc accorder aux principaux l'accès aux ressources Colab Enterprise via les rôles Vertex AI.
Le tableau suivant inclut tous les rôles prédéfinis Vertex AI.
Pour utiliser des rôles prédéfinis pour les opérations courantes de Colab Enterprise, consultez Administrateur Colab Enterprise (
roles/aiplatform.colabEnterpriseAdmin) et Utilisateur Colab Enterprise (roles/aiplatform.colabEnterpriseUser).Pour 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).Les rôles Administrateur Vertex AI (
roles/aiplatform.admin), Utilisateur Vertex AI (roles/aiplatform.user) et Lecteur Vertex AI (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. |
|
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. |
|
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 l'ensemble de 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 répertorie 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 Vertex AI | service-PROJECT_NUMBER@gcp-sa-aiplatform.iam.gserviceaccount.com |
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.iam.gserviceaccount.com |
roles/aiplatform.colabServiceAgent |
| Agent de service de notebook Vertex AI | Exécuter des ressources gérées par notebook dans le projet utilisateur avec des autorisations limitées | service-PROJECT_NUMBER@gcp-sa-aiplatform-vm.iam.gserviceaccount.com |
roles/aiplatform.notebookServiceAgent |
Si vous supprimez les rôles par défaut des agents de service Colab Enterprise, Colab Enterprise peut les réattribuer automatiquement pour assurer la continuité des fonctionnalités du service. Pour désactiver le service Colab Enterprise, vous devez désactiver les API concernées au lieu de supprimer des rôles.
Considérations liées à la sécurité pour les autorisations Colab Enterprise
Lorsqu'un utilisateur crée un notebook Colab Enterprise, le rôle Propriétaire du code (roles/dataform.codeOwner) lui est automatiquement attribué pour ce notebook. Cette attribution de rôle au niveau de la ressource est distincte de tout rôle IAM au niveau du projet.
IAM organise les stratégies de manière hiérarchique :
- Un utilisateur peut disposer d'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 règle 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 à partir d'un notebook.
- Créez une stratégie IAM de refus pour révoquer toutes les autorisations de l'utilisateur sur toutes les ressources du projet.
É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