Gestionar el acceso a un cuaderno

Gestionar el acceso a un cuaderno

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

Antes de empezar

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

Roles obligatorios

Para obtener los permisos que necesitas para gestionar el acceso a un cuaderno de Colab Enterprise, pide a tu administrador que te conceda el rol de gestión de identidades y accesos Administrador de Colab Enterprise (roles/aiplatform.colabEnterpriseAdmin) en el proyecto. Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.

Uno o varios de los roles obligatorios incluyen el permiso dataform.repositories.list. Los usuarios a los que se les haya concedido el permiso dataform.repositories.list o el rol Creador de código (roles/dataform.codeCreator) en un proyecto pueden enumerar los nombres de los recursos 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 sean administradores y usen BigQuery Studio solo podrán ver los recursos de código que hayan creado o que se hayan compartido con ellos.

Conceder acceso a un cuaderno

En esta sección se describe cómo conceder acceso a un cuaderno de Colab Enterprise a una entidad.

Importante: Los usuarios que tengan acceso al cuaderno podrán ver todos los resultados generados por el código del cuaderno. Los usuarios pueden ver este resultado aunque contenga datos de recursos a los que no tienen acceso. Para evitar que se comparta el resultado guardado, desactiva la opción de guardar el resultado del cuaderno.

Para conceder acceso a un principal a un cuaderno de Colab Enterprise, haz lo siguiente:

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

   Ir a Mis cuadernos

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

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

4. En la ventana Permisos de uso compartido, haz clic en  Añadir usuario o grupo.

5. En el cuadro de diálogo Añadir usuario o grupo, introduce uno o varios principales en el campo Nuevos principales, separados por comas.

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

   • Código Propietario: puede realizar cualquier acción en el cuaderno, como eliminarlo o compartirlo.
   • Editor de código: puede editar el cuaderno.
   • Lector de código: puede ver el cuaderno.
   El principal también debe tener el rol Usuario del tiempo de ejecución del cuaderno (roles/aiplatform.notebookRuntimeUser) para ejecutar el cuaderno.

7. Haz clic en Guardar.

Las entidades principales de Colab Enterprise son usuarios, grupos o dominios

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

Principal	Cuenta de usuario de ejemplo
Un solo usuario	[e-mail]
Grupo de Google	[e-mail]
Dominio de Google Workspace	example.com

Desactivar el guardado de la salida del cuaderno

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

Si desactivas el guardado de la salida de un cuaderno seleccionado, Colab Enterprise eliminará toda la salida guardada en el archivo del cuaderno y no guardará la salida de las ejecuciones posteriores.

Sin embargo, los usuarios que tengan acceso al cuaderno podrán seguir viendo su salida de las siguientes formas:

• Ejecuta el cuaderno para ver su salida actual. Este resultado no se guarda.

• Ver una versión archivada del cuaderno y su salida en el historial de revisiones.

Para desactivar el guardado de resultados de un cuaderno seleccionado, sigue estos pasos:

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

   Ir a Mis cuadernos

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

3. Para abrir una libreta, haz clic en su nombre.

4. Haz clic en  Mostrar u ocultar el encabezado > Editar > Configuración del cuaderno.

5. En la ventana Configuración del cuaderno, selecciona Omitir resultado de las celdas de código al guardar este cuaderno.

6. Haz clic en Guardar.

7. Haz clic en Volver a cargar.

Revocar el acceso a un cuaderno

Para revocar el acceso a un cuaderno de Colab Enterprise, sigue estos pasos:

1. En la consola, ve a la página Gestión de identidades y accesos. Google Cloud

   Ir a IAM

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

3. Busca la fila que contenga la cuenta principal cuyo acceso quieras revocar. A continuación, haz clic en Editar principal en esa fila.

   Nota: No puedes editar los roles heredados al gestionar el acceso a un recurso. Para editar los roles heredados, ve al recurso en el que se concedió el rol.

4. Haga clic en el botón Eliminar del rol que quiera revocar y, a continuación, haga clic en Guardar.

Siguientes pasos

• Para saber cómo conceder acceso a una plantilla de tiempo de ejecución, consulte Gestionar el acceso a una plantilla de tiempo de ejecución.