Faça a gestão do acesso a um notebook

Faça a gestão do acesso a um notebook

Esta página descreve como pode conceder e revogar o acesso a um bloco de notas do Colab Enterprise (ficheiro IPYNB).

Antes de começar

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.

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 (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 (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

Funções necessárias

Para receber as autorizações de que precisa para gerir o acesso a um bloco de notas do Colab Enterprise, peça ao seu administrador para lhe conceder a função do IAM de administrador do Colab Enterprise (roles/aiplatform.colabEnterpriseAdmin) no projeto. Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

Uma ou mais das funções necessárias incluem a autorização dataform.repositories.list. Os utilizadores aos quais é concedida a autorização dataform.repositories.list ou a função Criador de código (roles/dataform.codeCreator) num projeto podem listar os nomes dos recursos de código nesse projeto através da API Dataform ou da interface de linha de comandos (CLI) do Dataform. Os não administradores que usam o BigQuery Studio só podem ver recursos de código que criaram ou que foram partilhados com eles.

Conceda acesso a um notebook

Esta secção descreve como conceder a um principal acesso a um bloco de notas do Colab Enterprise.

Importante: os utilizadores com acesso ao bloco de notas podem ver todos os resultados gerados pelo código no bloco de notas. Os utilizadores podem ver este resultado mesmo que o resultado contenha dados de recursos aos quais não têm acesso. Para impedir que o resultado guardado seja partilhado, desative a opção de guardar o resultado do bloco de notas.

Para conceder a um principal acesso a um bloco de notas do Colab Enterprise, faça o seguinte:

1. Na Google Cloud consola, aceda à página Os meus blocos de notas do Colab Enterprise.

   Aceda a Os meus notebooks

2. No menu Região, selecione a região que contém o seu bloco de notas.

3. Junto ao bloco de notas que quer partilhar, clique no menu Ações do bloco de notas e selecione Partilhar.

4. Na janela Partilhar autorizações, clique em  Adicionar utilizador/grupo.

5. Na caixa de diálogo Adicionar utilizador/grupo, no campo Novos responsáveis, introduza um ou mais responsáveis separados por vírgulas.

6. Na lista Função, selecione uma das seguintes funções:

   • Código Proprietário: pode realizar qualquer ação no bloco de notas, incluindo eliminá-lo ou partilhá-lo.
   • Editor de código: pode editar o bloco de notas.
   • Código Visitante: pode ver o notebook.
   O diretor também tem de ter a função Notebook Runtime User (roles/aiplatform.notebookRuntimeUser) para executar o bloco de notas.

7. Clique em Guardar.

Os principais do Colab Enterprise são utilizadores, grupos ou domínios

Pode conceder acesso a utilizadores, grupos ou domínios. Veja a seguinte tabela:

Principal	Conta de utilizador de exemplo
Utilizador único	[e-mail]
Grupo Google	[e-mail]
Domínio do Google Workspace	example.com

Desative a gravação da saída do notebook

Para impedir a partilha da saída do notebook guardada com outros utilizadores que tenham acesso ao ficheiro do notebook, pode desativar a poupança da saída do notebook.

Quando desativa a opção de guardar a saída para um bloco de notas selecionado, o Colab Enterprise elimina toda a saída guardada no ficheiro do bloco de notas e não guarda a saída das execuções subsequentes.

No entanto, os utilizadores que têm acesso ao bloco de notas podem continuar a ver o respetivo resultado das seguintes formas:

• Execute o bloco de notas para ver o respetivo resultado atual. Esta saída não é guardada.

• Veja uma versão de arquivo do bloco de notas e a respetiva saída no histórico de revisões.

Para desativar a poupança de resultados para um bloco de notas selecionado, faça o seguinte:

1. Na Google Cloud consola, aceda à página Os meus blocos de notas do Colab Enterprise.

   Aceda a Os meus notebooks

2. No menu Região, selecione a região que contém o seu bloco de notas.

3. Para abrir um bloco de notas, clique no respetivo nome.

4. Clique em  Ativar/desativar visibilidade do cabeçalho > Editar > Definições do bloco de notas.

5. Na janela Definições do bloco de notas, selecione Omitir saída das células de código ao guardar este bloco de notas.

6. Clique em Guardar.

7. Clique em Recarregar.

Revogue o acesso a um bloco de notas

Para revogar o acesso a um bloco de notas do Colab Enterprise:

1. Na Google Cloud consola, aceda à página IAM.

   Aceda ao IAM

2. Selecione um projeto, uma pasta ou uma organização.

3. Procure a linha que contém o principal cujo acesso quer revogar. Em seguida, clique em Editar principal nessa linha.

   Nota: não pode editar funções herdadas quando gere o acesso a um recurso. Para editar funções herdadas, aceda ao recurso onde a função foi concedida.

4. Clique no botão Eliminar para a função que quer revogar e, de seguida, clique em Guardar.

O que se segue?

• Para saber como conceder acesso a um modelo de tempo de execução, consulte o artigo Faça a gestão do acesso a um modelo de tempo de execução.