Gestire l'accesso all'interfaccia JupyterLab di un'istanza

Questa pagina descrive come concedere l'accesso all'interfaccia JupyterLab di un'istanza di Vertex AI Workbench.

Puoi controllare l'accesso all'interfaccia JupyterLab di un'istanza di Vertex AI Workbench tramite la modalità di accesso dell'istanza. Puoi impostare una modalità di accesso a JupyterLab quando crei un'istanza di Vertex AI Workbench. La modalità di accesso non può essere modificata dopo la creazione del blocco note.

La modalità di accesso a JupyterLab determina chi può utilizzare l'interfaccia JupyterLab dell'istanza. La modalità di accesso determina anche quali credenziali vengono utilizzate quando l'istanza interagisce con altri servizi Google Cloud.

Limitazioni di accesso

La concessione di un accesso dell'entità all'interfaccia JupyterLab di un'istanza di Vertex AI Workbench non concede l'accesso all'istanza stessa. Ad esempio, per avviare, arrestare o reimpostare un'istanza, devi concedere l'accesso all'entità per eseguire queste operazioni impostando un criterio IAM sull'istanza. Per concedere l'accesso all'istanza di Vertex AI Workbench, consulta Gestire l'accesso a un'istanza di Vertex AI Workbench.

Modalità di accesso a JupyterLab

Le istanze di Vertex AI Workbench supportano le seguenti modalità di accesso:

  • Solo utente singolo: la modalità di accesso Solo utente singolo consente l'accesso solo all'utente da te specificato.

  • Account di servizio: la modalità di accesso Account di servizio concede l'accesso a un account di servizio. Puoi concedere l'accesso a uno o più utenti tramite questo account di servizio.

Solo utente singolo

Quando crei un'istanza di Vertex AI Workbench con accesso Solo utente, specifichi un account utente. L'account utente specificato è l'unico utente con accesso all'interfaccia JupyterLab. Se l'utente specificato non è il creatore dell'istanza, devi concedergli il ruolo Utente account di servizio (roles/iam.serviceAccountUser) nell'account di servizio dell'istanza. Se l'istanza deve accedere ad altre risorse Google Cloud, anche questo account di servizio deve avere accesso a queste risorse Google Cloud.

Concedere l'accesso a un singolo utente

Per concedere l'accesso a un singolo utente:

  1. Crea un'istanza di Vertex AI Workbench con le seguenti specifiche:

    1. Nella finestra di dialogo Crea istanza, nella sezione IAM e sicurezza, seleziona la modalità di accesso Solo utente singolo.

    2. Nel campo Email utente, inserisci l'account utente a cui vuoi concedere l'accesso.

  2. Completa il resto della finestra di dialogo e fai clic su Crea.

Account di servizio

Quando crei un'istanza di Vertex AI Workbench con accesso come account di servizio, devi specificare un account di servizio. Se l'istanza deve accedere ad altre risorse Google, questo account di servizio deve avere accesso anche a quelle risorse Google.

Quando specifichi un account di servizio, scegli una delle seguenti opzioni:

  • Seleziona l'account di servizio predefinito di Compute Engine.
  • Specifica un account di servizio personalizzato. L'account di servizio personalizzato deve trovarsi nello stesso progetto dell'istanza di Vertex AI Workbench. Per creare l'istanza, devi disporre dell'autorizzazione iam.serviceAccounts.actAs nell'account di servizio.

Per concedere l'accesso agli utenti tramite un account di servizio, concedi l'autorizzazione iam.serviceAccounts.actAs nell'account di servizio specificato per ogni utente che deve accedere a JupyterLab.

Concedere l'accesso a più utenti tramite un account di servizio

  1. Crea un'istanza di Vertex AI Workbench con le seguenti specifiche:

    1. Nella finestra di dialogo Crea istanza, nella sezione IAM e sicurezza, seleziona la modalità di accesso Account di servizio.

    2. Scegli l'account di servizio predefinito di Compute Engine o un account di servizio personalizzato.

      • Per utilizzare l'account di servizio predefinito di Compute Engine, seleziona Utilizza l'account di servizio predefinito di Compute Engine.

      • Per utilizzare un account di servizio personalizzato, deseleziona Utilizza account di servizio predefinito di Compute Engine, quindi inserisci l'indirizzo email dell'account di servizio personalizzato nel campo Email account di servizio.

  2. Completa il resto della finestra di dialogo e fai clic su Crea.

  3. Per ogni utente che deve accedere a JupyterLab, concedi l'autorizzazione iam.serviceAccounts.actAs sul tuo account di servizio.

Metadati modalità di accesso

La modalità di accesso che configuri durante la creazione dell'istanza di Vertex AI Workbench viene archiviata nei metadati del blocco note.

Quando selezioni la modalità di accesso Solo utente singolo, Vertex AI Workbench archivia un valore per proxy-mode e proxy-user-mail. Di seguito sono riportati alcuni esempi di voci di metadati di accesso singolo utente:

  • proxy-mode=mail
  • proxy-user-mail=user@example.com

Quando selezioni la modalità di accesso Account di servizio, Vertex AI Workbench archivia una voce di metadati proxy-mode=service_account.

Passaggi successivi