Gestire l'accesso a un notebook

Gestire l'accesso a un notebook

Questa pagina descrive come concedere e revocare l'accesso a un notebook Colab Enterprise (file IPYNB).

Prima di iniziare

Accedi al tuo Google Cloud account. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei workload.

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

Verify that billing is enabled for your Google Cloud project.

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

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

Verify that billing is enabled for your Google Cloud project.

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

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per gestire l'accesso a un notebook Colab Enterprise, chiedi all'amministratore di concederti il ruolo IAM Amministratore Colab Enterprise (roles/aiplatform.colabEnterpriseAdmin) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Uno o più dei ruoli richiesti includono l'dataform.repositories.list autorizzazione. Gli utenti a cui è stata concessa l'autorizzazione dataform.repositories.list o il ruolo Code Creator (roles/dataform.codeCreator) in un progetto possono elencare i nomi degli asset di codice in quel progetto utilizzando l'API Dataform o l' interfaccia a riga di comando (CLI) Dataform. I non amministratori che utilizzano BigQuery Studio possono visualizzare solo gli asset di codice che hanno creato o che sono stati condivisi con loro.

Concedere l'accesso a un notebook

Questa sezione descrive come concedere a un'entità l'accesso a un notebook Colab Enterprise.

Importante: gli utenti che hanno accesso al notebook possono visualizzare tutto l'output generato dal codice nel notebook. Gli utenti possono visualizzare questo output anche se contiene dati provenienti da risorse a cui non hanno accesso. Per impedire la condivisione dell'output salvato, disattiva il salvataggio dell'output del notebook.

Per concedere a un'entità l'accesso a un notebook Colab Enterprise:

1. Nella Google Cloud console, vai a alla pagina I miei notebook di Colab Enterprise.

   Vai a I miei notebook

2. Nel menu Regione, seleziona la regione che contiene il notebook.

3. Accanto al notebook che vuoi condividere, fai clic sul menu Azioni notebook e seleziona Condividi.

4. Nella finestra Condividi autorizzazioni, fai clic su  Aggiungi utente/gruppo.

5. Nella finestra di dialogo Aggiungi utente/gruppo , nel campo Nuove entità, inserisci una o più entità separate da virgole.

6. Nell'elenco Ruolo, seleziona uno dei seguenti ruoli:

   • Proprietario del codice: può eseguire qualsiasi azione sul notebook, inclusa l'eliminazione o la condivisione.
   • Editor di codice: può modificare il notebook.
   • Codice Visualizzatore: può visualizzare il notebook.
   L'entità deve avere anche il ruolo Utente runtime notebook (roles/aiplatform.notebookRuntimeUser) per eseguire il notebook.

7. Fai clic su Salva.

Le entità Colab Enterprise sono utenti, gruppi o domini

Puoi concedere l'accesso a utenti, gruppi o domini. Consulta la tabella seguente:

Entità	Account utente di esempio
Utente singolo	[e-mail]
Gruppo Google	[e-mail]
Dominio Google Workspace	example.com

Disattivare il salvataggio dell'output del notebook

Per impedire la condivisione dell'output del notebook salvato con altri utenti che hanno accesso al file del notebook, puoi disattivare il salvataggio dell'output del notebook.

Quando disattivi il salvataggio dell'output per un notebook selezionato, Colab Enterprise elimina tutto l'output salvato nel file del notebook e non salva l'output delle esecuzioni successive.

Tuttavia, gli utenti che hanno accesso al notebook possono comunque visualizzarne l'output nei seguenti modi:

• Esegui il notebook per visualizzarne l'output corrente. Questo output non viene salvato.

• Visualizza una versione di archivio del notebook e del suo output nella cronologia delle revisioni.

Per disattivare il salvataggio dell'output per un notebook selezionato:

1. Nella Google Cloud console, vai a alla pagina I miei notebook di Colab Enterprise.

   Vai a I miei notebook

2. Nel menu Regione, seleziona la regione che contiene il notebook.

3. Per aprire un notebook, fai clic sul relativo nome.

4. Fai clic su  Attiva/disattiva la visibilità dell'intestazione > Modifica > Impostazioni notebook.

5. Nella finestra Impostazioni notebook, seleziona Escludi output delle celle di codice durante il salvataggio del notebook.

6. Fai clic su Salva.

7. Fai clic su Ricarica.

Revocare l'accesso a un notebook

Per revocare l'accesso a un notebook Colab Enterprise:

1. Nella Google Cloud console, vai alla pagina IAM.

   Vai a IAM

2. Seleziona un progetto, una cartella o un'organizzazione.

3. Individua la riga contenente l'entità di cui vuoi revocare l'accesso. Quindi, fai clic su Modifica entità in quella riga.

   Nota: non puoi modificare i ruoli ereditati quando gestisci l'accesso a una risorsa. Per modificare i ruoli ereditati, vai alla risorsa in cui è stato concesso il ruolo.

4. Fai clic sul pulsante Elimina per il ruolo che vuoi revocare, quindi fai clic su Salva.

Passaggi successivi

• Per scoprire come concedere l'accesso a un modello di runtime, consulta Gestire l'accesso a un modello di runtime.