Gerenciar o acesso a um notebook

Gerenciar o acesso a um notebook

Esta página descreve como conceder e revogar o acesso a um notebook do Colab Enterprise (arquivo IPYNB).

Antes de começar

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

Funções exigidas

Para garantir que sua conta de usuário tenha as permissões necessárias para gerenciar o acesso a um bloco do Colab Enterprise, peça ao administrador para conceder à sua conta de usuário o papel de Administrador do Colab Enterprise (roles/aiplatform.colabEnterpriseAdmin) do IAM no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

O administrador também pode conceder à sua conta de usuário as permissões necessárias via funções personalizadas ou outros papéis predefinidos.

Um ou mais dos papéis necessários incluem a permissão dataform.repositories.list. Os usuários que recebem a permissão dataform.repositories.list ou o papel de criador de código (roles/dataform.codeCreator) em um projeto podem listar os nomes dos recursos de código nesse projeto usando a API Dataform ou a interface de linha de comando (CLI) do Dataform. Os não administradores que usam o BigQuery Studio só podem ver os recursos de código que criaram ou que foram compartilhados com eles.

Conceder acesso a um notebook

Esta seção descreve como conceder acesso principal a um notebook do Colab Enterprise.

Importante: os usuários que têm acesso ao notebook podem ver toda a saída gerada pelo código no notebook. Os usuários podem ver essa saída mesmo que ela contenha dados de recursos aos quais eles não têm acesso. Para evitar que a saída salva seja compartilhada, desative o salvamento de saída do notebook.

Para conceder a um principal o acesso a um notebook do Colab Enterprise, faça o seguinte:

1. No console do Google Cloud, acesse a página Notebooks do Colab Enterprise.

   Acesse o Notebooks

2. No menu Região, selecione a região que contém o notebook.

3. Ao lado do notebook que você quer compartilhar, clique no menu Ações do notebook e selecione Compartilhar.

4. Na janela Compartilhar permissões, clique em  Adicionar usuário/grupo.

5. Na caixa de diálogo Adicionar usuário/grupo, no campo Novos participantes, insira um ou mais participantes separados por vírgulas.

6. Na lista Papel, selecione um dos seguintes papéis:

   • Proprietário de código: pode realizar qualquer ação no notebook, inclusive excluí-lo ou compartilhá-lo.
   • Editor de código: pode editar o notebook.
   • Leitor de código: pode acessar o notebook.
   O principal também precisa ter o papel de Usuário do ambiente de execução do notebook (roles/aiplatform.notebookRuntimeUser) para executar o notebook.

7. Clique em Salvar.

Os participantes do Colab Enterprise são usuários, grupos ou domínios

É possível conceder acesso a usuários, grupos ou domínios. Confira a tabela a seguir:

Principal	Exemplo de conta de usuário
Único usuário	[e-mail]
Grupo do Google	[e-mail]
Domínio do Google Workspace	example.com

Desativar o salvamento de saída do notebook

Para evitar o compartilhamento da saída salva do notebook com outros usuários que tenham acesso ao arquivo do notebook, desative o salvamento de saída do notebook.

Quando você desativa o salvamento de saída em um notebook selecionado, o Colab Enterprise exclui todas as saídas salvas no arquivo do notebook e não salva a saída de execuções subsequentes.

No entanto, os usuários com acesso ao notebook ainda poderão visualizar a saída das seguintes maneiras:

• Execute o notebook para conferir a saída atual. Essa saída não é salva.

• Conferir uma versão de arquivo do notebook e a saída no histórico de revisões.

Para desativar o salvamento da saída de um notebook selecionado, faça o seguinte:

1. No console do Google Cloud, acesse a página Notebooks do Colab Enterprise.

   Acesse o Notebooks

2. No menu Região, selecione a região que contém o notebook.

3. Selecione o notebook em que você quer desativar o salvamento de saída.

4. Clique em  Alternar visibilidade do cabeçalho > Editar > Configurações do notebook.

5. Na janela Configurações do notebook, selecione Omitir saída da célula de código ao salvar este notebook.

6. Clique em Salvar.

7. Clique em Atualizar.

Revogar acesso a um notebook

Para revogar o acesso a um bloco do Colab Enterprise:

1. No console do Google Cloud, abra a página IAM.

   Acessar IAM

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

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

   Observação: não é possível editar papéis herdados ao gerenciar o acesso a um recurso. Para editar os papéis herdados, acesse o recurso em que o papel foi concedido.

4. Clique no botão Excluir do papel que você quer revogar e clique em Salvar.

A seguir

• Para saber como conceder acesso a um modelo de ambiente de execução, consulte Gerenciar o acesso a um modelo de ambiente de execução.