Administra el acceso a un notebook

Administra el acceso a un notebook

En esta página, se describe cómo puedes otorgar y revocar el acceso a un notebook de Colab Enterprise (archivo IPYNB).

Antes de comenzar

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

Roles obligatorios

Para asegurarte de que tu cuenta de usuario tenga los permisos necesarios para administrar el acceso a un notebook de Colab Enterprise, pídele a tu administrador que le otorgue el rol de IAM de administrador de Colab Enterprise (roles/aiplatform.colabEnterpriseAdmin) en el proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Es posible que tu administrador también pueda otorgar a tu cuenta de usuario los permisos necesarios a través de roles personalizados o de otros roles predefinidos.

Uno o más de los roles necesarios incluyen el permiso dataform.repositories.list. Los usuarios a los que se les otorgó el permiso dataform.repositories.list o el rol Creador de código (roles/dataform.codeCreator) en un proyecto pueden enumerar los nombres de los elementos de código de ese proyecto mediante la API de Dataform o la interfaz de línea de comandos (CLI) de Dataform. Los usuarios que no son administradores que usan BigQuery Studio solo pueden ver los elementos de código que crearon o que se compartieron con ellos.

Otorga acceso a un notebook

En esta sección, se describe cómo otorgar acceso principal a un notebook de Colab Enterprise.

Importante: Los usuarios que tienen acceso al notebook pueden ver todos los resultados que generó el código en el notebook. Los usuarios pueden ver este resultado, incluso si contiene datos de recursos a los que no tienen acceso. Para evitar que se comparta el resultado guardado, desactiva el guardado de resultados del notebook.

Para otorgar acceso principal a un notebook de Colab Enterprise, haz lo siguiente:

1. En la consola de Google Cloud, ve a la página Notebooks de Colab Enterprise.

   Ir a Notebooks

2. En el menú Región, selecciona la región que contiene el notebook.

3. Junto al notebook que deseas compartir, haz clic en el menú Acciones del notebook y selecciona Compartir.

4. En la ventana Compartir permisos, haz clic en  Agregar usuario o grupo.

5. En el cuadro de diálogo Agregar usuario o grupo, en el campo Principales nuevas, ingresa uno o más principales con comas entre ellos.

6. En la lista Rol, selecciona uno de los siguientes roles:

   • Propietario del código: Puede realizar cualquier acción en el notebook, incluida la eliminación o el uso compartido.
   • Editor de código: Puede editar el notebook.
   • Visualizador de código: Puede ver el notebook.
   La principal también debe tener el rol de Usuario del entorno de ejecución del notebook (roles/aiplatform.notebookRuntimeUser) para ejecutar el notebook.

7. Haz clic en Guardar.

Los principales de Colab Enterprise son usuarios, grupos o dominios

Puedes otorgar acceso a usuarios, grupos o dominios. Consulta la siguiente tabla:

Principal	Ejemplo de cuenta de usuario
Único usuario	[e-mail]
Grupo de Google	[e-mail]
Dominio de Google Workspace	example.com

Cómo desactivar el guardado de resultados del notebook

Para evitar que se comparta el resultado del notebook guardado con otros usuarios que tengan acceso al archivo del notebook, puedes desactivar el guardado de resultados del notebook.

Cuando desactivas el guardado de resultados para un notebook seleccionado, Colab Enterprise borra todos los resultados guardados en el archivo del notebook y no guarda el resultado de las ejecuciones posteriores.

Sin embargo, los usuarios que tienen acceso al notebook aún pueden ver el resultado de las siguientes maneras:

• Ejecuta el notebook para ver su resultado actual. No se guarda este resultado.

• Visualiza una versión de archivo del notebook y su resultado en el historial de revisión.

Para desactivar el guardado de resultados en un notebook seleccionado, haz lo siguiente:

1. En la consola de Google Cloud, ve a la página Notebooks de Colab Enterprise.

   Ir a Notebooks

2. En el menú Región, selecciona la región que contiene el notebook.

3. Selecciona el notebook para el que quieres desactivar el guardado de salida.

4. Haz clic en  Activar o desactivar la visibilidad del encabezado > Editar > Configuración del notebook.

5. En la ventana Configuración del notebook, selecciona Omitir el resultado de las celdas al guardar este notebook.

6. Haz clic en Guardar.

7. Haz clic en Volver a cargar.

Cómo revocar el acceso a un notebook

Para revocar el acceso a un notebook de Colab Enterprise, haz lo siguiente:

1. En la consola de Google Cloud, ve a la página IAM.

   Ir a IAM

2. Selecciona un proyecto, una carpeta o una organización.

3. Busca la fila que contiene el principal cuyo acceso deseas revocar. Luego, haz clic en Editar principal en esa fila.

   Nota: No puedes editar las funciones heredadas cuando administras el acceso a un recurso. Para editar las funciones heredadas, ve al recurso en el que se otorgó la función.

4. Haz clic en el botón Borrar para el rol que deseas revocar y, luego, haz clic en Guardar.

¿Qué sigue?

• Para obtener información sobre cómo otorgar acceso a una plantilla de entorno de ejecución, consulta Administra el acceso a una plantilla de entorno de ejecución.