È necessario configurare un client OAuth e generare le credenziali OAuth durante la creazione dell'istanza di Looker (Google Cloud core), anche se vuoi utilizzare un metodo di autenticazione diverso per autenticare gli utenti in un'istanza di Looker (Google Cloud core).
Ruoli obbligatori
Per utilizzare la Google Cloud console per creare e modificare le credenziali OAuth, devi disporre delle seguenti autorizzazioni. Per nascondere l'elenco delle autorizzazioni, comprimi la sezione Autorizzazioni richieste.
Autorizzazioni obbligatorie
- clientauthconfig.*
- clientauthconfig.brands.create
- clientauthconfig.brands.delete
- clientauthconfig.brands.get
- clientauthconfig.brands.list
- clientauthconfig.brands.update
- clientauthconfig.clients.create
- clientauthconfig.clients.createSecret
- clientauthconfig.clients.delete
- clientauthconfig.clients.get
- clientauthconfig.clients.getWithSecret
- clientauthconfig.clients.list
- clientauthconfig.clients.listWithSecrets
- clientauthconfig.clients.undelete
- clientauthconfig.clients.update
- oauthconfig.*
- oauthconfig.clientpolicy.get
- oauthconfig.testusers.get
- oauthconfig.testusers.update
- oauthconfig.verification.get
- oauthconfig.verification.submit
- oauthconfig.verification.update
Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti. Per saperne di più sulla concessione dei ruoli, consulta la pagina Gestire l'accesso a progetti, cartelle e organizzazioni nella documentazione di Identity and Access Management (IAM).
Prima di creare un'istanza di Looker (Google Cloud core)
Prima di creare un'istanza di Looker (Google Cloud core), completa i passaggi descritti in queste sezioni:
- Generare l'ID client e il client secret OAuth
- Configurare la schermata del consenso dell'utente, gli ambiti e gli utenti di test
Genera l'ID client e il client secret OAuth
Innanzitutto, crea un client OAuth e genera l'ID client e il client secret per il client. Questi valori sono obbligatori durante la creazione dell'istanza di Looker (Google Cloud core).
Puoi configurare il client OAuth in qualsiasi Google Cloud progetto. Non deve necessariamente essere lo stesso progetto dell'istanza di Looker (Google Cloud core). Tuttavia, l'API Looker (Google Cloud core) deve essere abilitata in questo progetto.
Per creare il client e le relative credenziali:
- Vai al progetto in cui vuoi creare il client OAuth.
- Vai ad API e servizi > Credenziali.
- Nella pagina Credenziali, fai clic su Crea credenziali.
- Dal menu a discesa, seleziona ID client OAuth.
- Nel menu a discesa Tipo di applicazione, seleziona Applicazione web.
- Nel campo Nome, inserisci un nome per il client OAuth.
- A questo punto, non è necessario aggiungere URI nelle sezioni Origini JavaScript autorizzate o URI di reindirizzamento autorizzati.
- Fai clic su Crea.
Dopo aver fatto clic su Crea, viene visualizzata la finestra Client OAuth creato. Questa finestra mostra l'ID client e il client secret creati per il client OAuth. Questi valori saranno richiesti quando crei l'istanza di Looker (Google Cloud core).
Se vuoi, fai clic su Scarica JSON per scaricare le informazioni sulle credenziali in un file JSON. Per chiudere la finestra, fai clic su OK.
Configura la schermata del consenso dell'utente, gli ambiti e gli utenti di test
Successivamente, ti consigliamo di configurare la schermata del consenso. La schermata del consenso viene mostrata a un utente dell'istanza Looker (Google Cloud core) al primo accesso e in qualsiasi momento in cui l'autorizzazione scade o viene revocata dall'utente.
Segui le istruzioni riportate nella pagina della documentazione Configurare la schermata per il consenso OAuth e scegliere gli ambiti. Durante la configurazione dello schermo, completa le seguenti impostazioni come descritto:
Nella sezione Branding, in Domini autorizzati, il dominio deve corrispondere a quello dell'istanza di Looker (Google Cloud core) che utilizza le credenziali OAuth. Se hai intenzione di creare un dominio personalizzato per la tua istanza di Looker (Google Cloud core) e conosci il dominio che vuoi assegnarle, puoi inserirlo subito. In caso contrario, puoi lasciare vuoto questo campo, che verrà compilato automaticamente quando aggiungi l'URI di reindirizzamento autorizzato dopo la creazione dell'istanza di Looker (Google Cloud core).
Nella sezione Pubblico, in Tipo di utente, seleziona una delle seguenti opzioni:
- Interna: questa è l'impostazione predefinita. Solo gli utenti all'interno della tua organizzazione possono accedere all'istanza dopo essere stati aggiunti tramite IAM.
- Rendi esterno: gli utenti con qualsiasi tipo di Account Google possono accedere all'istanza dopo essere stati aggiunti tramite IAM.
Durante la creazione dell'istanza di Looker (Google Cloud core)
Quando crei l'istanza di Looker (Google Cloud core), aggiungi l'ID client OAuth e il client secret nella sezione Credenziali applicazione OAuth. Non puoi creare un'istanza senza credenziali OAuth. Per trovare l'ID client OAuth e il client secret, vai al client OAuth nella Google Cloud console.
Dopo aver creato un'istanza di Looker (Google Cloud core)
Completa le seguenti istruzioni per completare la configurazione. Quando aggiungi un URI di reindirizzamento autorizzato, questo viene aggiunto alla schermata di consenso OAuth come dominio autorizzato.
Aggiungi l'URI di reindirizzamento autorizzato al client OAuth
Se non l'hai ancora fatto, segui questi passaggi per inserire l'URL dell'istanza di Looker (Google Cloud core) appena creata nel client OAuth.
Dopo aver creato un'istanza di Looker (Google Cloud core), individua e copia l'URL dell'istanza. Puoi trovare l'URL nella pagina Istanze.
Nella Google Cloud console, vai a API e servizi > Credenziali.
Sotto l'intestazione ID client OAuth 2.0, fai clic sul nome del client che hai creato.
Nella sezione URI di reindirizzamento autorizzati, fai clic su Aggiungi URI.
Incolla l'URL dell'istanza di Looker (Google Cloud core) nel campo URI. Aggiungi
/oauth2callback
alla fine dell'URL. Ad esempio:https://uuid.looker.app/oauth2callback
.Se hai intenzione di configurare l'autorizzazione OAuth per BigQuery, puoi anche aggiungere un secondo URI di reindirizzamento che rimandi all'URL dell'istanza di Looker (Google Cloud core) seguito da
/external_oauth/redirect
aggiunto alla fine dell'URL. Ad esempio:https://uuid.looker.app/external_oauth/redirect
.Fai clic su Salva.
L'applicazione dell'aggiornamento potrebbe richiedere da cinque minuti ad alcune ore.
Gestisci utenti
Una volta configurato il client OAuth e creata l'istanza di Looker (Google Cloud core), puoi scegliere il metodo di autenticazione per l'istanza.
Se utilizzi OAuth come metodo di autenticazione principale, completa i passaggi descritti nella pagina della documentazione Utilizzare OAuth di Google per l'autenticazione utente di Looker (Google Cloud core) per completare la configurazione di OAuth per l'autenticazione utente.
Una volta configurato il metodo di autenticazione, puoi aggiungere o rimuovere utenti tramite il tuo provider di identità e gestirli in Looker.
Modifica il client OAuth per un'istanza di Looker (Google Cloud core)
Se vuoi, puoi modificare le credenziali OAuth per la tua istanza di Looker (Google Cloud core) seguendo questi passaggi:
- Configura il nuovo client o le nuove credenziali.
- Nella Google Cloud console, dalla pagina Istanze, fai clic sul nome di un'istanza per aprire la pagina Dettagli.
- Nella pagina Dettagli, fai clic su Modifica.
- Nella pagina Modifica istanza di Looker (Google Cloud core), inserisci i nuovi valori nei campi ID client OAuth e Client secret OAuth.
- Fai clic su Salva.
Passaggi successivi
- Crea un'istanza di Looker (Google Cloud core) con IP pubblico
- Crea un'istanza di Looker (Google Cloud core) con IP privato