Gestire l'accesso all'interfaccia JupyterLab di un'istanza di Agent Platform Workbench

Questa pagina descrive come concedere l'accesso all'interfaccia JupyterLab di un'istanza di Agent Platform Workbench di Gemini Enterprise.

Puoi controllare l'accesso all'interfaccia JupyterLab di un'istanza di Agent Platform Workbench tramite la modalità di accesso dell'istanza. Imposti una modalità di accesso a JupyterLab quando crei un'istanza di Agent Platform Workbench. La modalità di accesso non può essere modificata dopo la creazione del notebook.

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 Cloud de Confiance by S3NS servizi.

Limitazioni di accesso

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

Modalità di accesso a JupyterLab

Le istanze di Agent Platform Workbench supportano le seguenti modalità di accesso:

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

  • Service account: la modalità di accesso Service account 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 Agent Platform Workbench con accesso Solo utente singolo, devi specificare 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) sul service account dell'istanza. Se l' istanza deve accedere ad altre Cloud de Confiance risorse, questo account di servizio deve avere accesso anche a quelle Cloud de Confiance risorse.

Concedere l'accesso a un singolo utente

Per concedere l'accesso a un singolo utente, completa i seguenti passaggi.

  1. Crea un'istanza di Agent Platform 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.

Service account

Quando crei un'istanza di Agent Platform Workbench con accesso Service account, devi specificare un account di servizio. Se l'istanza deve accedere ad altre risorse Google, questo account di servizio deve avere accesso anche a queste risorse Google.

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

  • Seleziona il account di servizio Compute Engine predefinito.
  • Specifica un account di servizio personalizzato. Il account di servizio personalizzato deve trovarsi nello stesso progetto dell'istanza di Agent Platform Workbench. Per creare l'istanza, devi disporre dell'autorizzazione iam.serviceAccounts.actAs sul account di servizio.

Per concedere l'accesso agli utenti tramite un account di servizio, devi concedere l'autorizzazione iam.serviceAccounts.actAs sul 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 Agent Platform Workbench con le seguenti specifiche:

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

    2. Scegli il account di servizio Compute Engine predefinito o un service account personalizzato.

      • Per utilizzare il account di servizio Compute Engine predefinito, seleziona Usa il service account Compute Engine predefinito.

      • Per utilizzare un account di servizio personalizzato, deseleziona Usa il service account Compute Engine predefinito e poi, nel campo Email del service account , inserisci l'indirizzo email del account di servizio personalizzato.

  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 service account.

Metadati della modalità di accesso

La modalità di accesso che configuri durante la creazione dell'istanza di Agent Platform Workbench viene memorizzata nei metadati del notebook.

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

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

Quando selezioni la modalità di accesso Service account, Agent Platform Workbench memorizza una voce di metadati proxy-mode=service_account.

Passaggi successivi