Gérer l'accès à un notebook

Gérer l'accès à un notebook

Cette page explique comment accorder et révoquer l'accès à un notebook Colab Enterprise (fichier IPYNB).

Avant de commencer

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Vertex AI, Dataform, and Compute Engine APIs.

   Enable the APIs

5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

6. Make sure that billing is enabled for your Google Cloud project.

7. Enable the Vertex AI, Dataform, and Compute Engine APIs.

   Enable the APIs

Rôles requis

Pour vous assurer que votre compte utilisateur dispose des autorisations nécessaires pour gérer l'accès à un notebook Colab Enterprise, demandez à votre administrateur d'accorder à votre compte utilisateur le rôle IAM Administrateur Colab Enterprise (roles/aiplatform.colabEnterpriseAdmin) sur le projet. Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

Votre administrateur peut également attribuer à votre compte utilisateur les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.

Un ou plusieurs des rôles requis incluent l'autorisation dataform.repositories.list. Les utilisateurs disposant de l'autorisation dataform.repositories.list ou du rôle Créateur de code (roles/dataform.codeCreator) dans un projet peuvent répertorier les noms des composants de code de ce projet. À l'aide de l'API Dataform ou de l'interface de ligne de commande (CLI) Dataform. Les utilisateurs sans droits d'administrateur qui utilisent BigQuery Studio ne peuvent voir que les composants de code qu'ils ont créés ou qui ont été partagés avec eux.

Accorder l'accès à un notebook

Cette section explique comment accorder à un principal l'accès à un notebook Colab Enterprise.

Important :Les utilisateurs ayant accès au notebook peuvent voir tous les résultats générés par le code dans le notebook. Les utilisateurs peuvent voir cette sortie, même si elle contient des données provenant de ressources auxquelles ils n'ont pas accès. Pour empêcher le partage de la sortie enregistrée, désactivez l'enregistrement de la sortie du notebook.

Pour accorder à un compte principal l'accès à un notebook Colab Enterprise, procédez comme suit:

1. Dans la console Google Cloud, accédez à la page Notebooks de Colab Enterprise.

   Accéder à Notebooks

2. Dans le menu Région, sélectionnez la région qui contient votre notebook.

3. À côté du notebook que vous souhaitez partager, cliquez sur le menu Actions sur le notebook, puis sélectionnez Partager.

4. Dans la fenêtre Autorisations de partage, cliquez sur  Ajouter un utilisateur/groupe.

5. Dans la boîte de dialogue Ajouter un utilisateur/un groupe, dans le champ Nouveaux comptes principaux, saisissez un ou plusieurs comptes principaux en les séparant par des virgules.

6. Dans la liste Rôle, sélectionnez l'un des rôles suivants:

   • Propriétaire du code: peut effectuer n'importe quelle action sur le notebook, y compris le supprimer ou le partager.
   • Éditeur de code: peut modifier le notebook.
   • Lecteur de code: peut afficher le notebook.
   Le principal doit également disposer du rôle Utilisateur de l'environnement d'exécution de notebook (roles/aiplatform.notebookRuntimeUser) pour exécuter le notebook.

7. Cliquez sur Enregistrer.

Les comptes principaux Colab Enterprise sont des utilisateurs, des groupes ou des domaines.

Vous pouvez accorder l'accès à des utilisateurs, à des groupes ou à des domaines. Consultez le tableau suivant:

Compte principal	Exemple de compte utilisateur
Utilisateur unique	[e-mail]
Groupe Google	[e-mail]
Domaine Google Workspace	example.com

Désactiver l'enregistrement de la sortie du notebook

Pour empêcher le partage de la sortie de notebook enregistrée avec d'autres utilisateurs ayant accès au fichier notebook, vous pouvez désactiver l'enregistrement de la sortie de notebook.

Lorsque vous désactivez l'enregistrement des résultats pour un notebook sélectionné, Colab Enterprise supprime toutes les sorties enregistrées dans le fichier notebook et n'enregistre pas le résultat des exécutions ultérieures.

Toutefois, les utilisateurs qui ont accès au notebook peuvent toujours afficher son résultat des manières suivantes:

• Exécutez le notebook pour afficher ses résultats actuels. Ce résultat n'est pas enregistré.

• Affichez une version d'archivage du notebook et ses résultats dans l'historique des révisions.

Pour désactiver l'enregistrement des résultats pour un notebook sélectionné, procédez comme suit:

1. Dans la console Google Cloud, accédez à la page Notebooks de Colab Enterprise.

   Accéder à Notebooks

2. Dans le menu Région, sélectionnez la région qui contient votre notebook.

3. Sélectionnez le notebook pour lequel vous souhaitez désactiver l'enregistrement de la sortie.

4. Cliquez sur  Activer/Désactiver la visibilité de l'en-tête > Modifier > Paramètres du notebook.

5. Dans la fenêtre Paramètres du notebook, sélectionnez Exclure la sortie de la cellule de code lors de l'enregistrement de ce notebook.

6. Cliquez sur Enregistrer.

7. Cliquez sur Actualiser.

Révoquer l'accès à un notebook

Pour révoquer l'accès à un notebook Colab Enterprise:

1. Dans la console Google Cloud, accédez à la page IAM.

   Accéder à IAM

2. Sélectionnez un projet, un dossier ou une organisation.

3. Recherchez la ligne contenant le compte principal dont vous souhaitez révoquer l'accès. Cliquez ensuite sur Modifier le compte principal sur cette ligne.

   Remarque : Vous ne pouvez pas modifier les rôles hérités lorsque vous gérez l'accès à une ressource. Pour modifier les rôles hérités, accédez à la ressource où le rôle a été accordé.

4. Cliquez sur le bouton Supprimer () correspondant au rôle que vous souhaitez révoquer, puis cliquez sur Enregistrer.

Étape suivante

• Pour savoir comment accorder l'accès à un modèle d'environnement d'exécution, consultez la section Gérer l'accès à un modèle d'environnement d'exécution.