Attivazione dell'opzione di accesso alternativo

Looker può autenticare gli utenti utilizzando uno dei vari tipi di server di autenticazione, come Google OAuth, LDAP, SAML o OpenID Connect. L'attivazione di uno di questi metodi di autenticazione disattiverà altri sistemi di autenticazione, come email e password.

Gli amministratori di Looker possono fornire a un utente un'opzione di accesso alternativa che utilizza il suo indirizzo email se l'utente ha un ruolo di amministratore o l'autorizzazione login_special_email.

Abilitazione dell'accesso alternativo nell'istanza di Looker

Prima di poter abilitare l'opzione di accesso alternativo per un utente, l'istanza di Looker deve essere configurata in modo da accettare le credenziali email:

  1. Vai alla sezione Authentication (Autenticazione) del riquadro Admin (Amministrazione) e seleziona il tipo di autenticazione attualmente attivato: Google OAuth, LDAP, SAML o OpenID Connect.
  2. Nella sezione Opzioni di migrazione, attiva l'opzione Accesso alternativo per gli amministratori e gli utenti specificati.

Concedere all'utente l'autorizzazione a utilizzare un accesso alternativo

Solo gli utenti con il ruolo di amministratore o l'autorizzazione login_special_email possono utilizzare un accesso alternativo. Un modo per concedere l'autorizzazione login_special_email a un utente non amministratore è creare un nuovo ruolo che la contiene e assegnarlo all'utente, come descritto di seguito:

  1. Vai alla pagina Ruoli, che si trova nella sezione Utenti del riquadro Amministrazione.
  2. Fai clic sul pulsante Nuovo set di autorizzazioni.
  3. Inserisci un nome per il nuovo set di autorizzazioni, ad esempio Accesso alternativo.
  4. Seleziona la casella login_special_email.
  5. Fai clic su Nuovo set di autorizzazioni.
  6. Fai clic su Nuovo ruolo.
  7. Inserisci un nome per il nuovo ruolo, ad esempio Ruolo di accesso alternativo.
  8. Nell'elenco Set di autorizzazioni, seleziona il nuovo set di autorizzazioni dall'elenco.
  9. Nell'elenco Set di modelli, seleziona Tutti.
  10. Nell'elenco Utenti, seleziona l'utente a cui vuoi concedere l'autorizzazione di accesso alternativa.
  11. Fai clic sul pulsante Nuovo ruolo per salvare il nuovo ruolo.
  12. Fai clic su Conferma.

Creazione delle credenziali email per l'utente

Dopo aver concesso all'utente l'autorizzazione a utilizzare le credenziali email, il passaggio successivo consiste nel creare le credenziali. Per creare credenziali email, un amministratore di Looker può utilizzare l'API Looker per effettuare una richiesta POST o utilizzare l'SDK dell'API Looker nel linguaggio di programmazione scelto dall'amministratore.

invia una richiesta POST all'API Looker

A causa della sua natura manuale, si tratta di un metodo migliore da utilizzare quando hai solo un numero limitato di utenti per i quali desideri configurare l'opzione di accesso alternativo.

In questo esempio viene utilizzato un comando curl per effettuare una richiesta POST all'endpoint API create_user_credentials_email utilizzando un token di accesso temporaneo:

  1. Per generare il token temporaneo (ACCESS_TOKEN), segui le istruzioni per Autenticazione senza un SDK nella pagina della documentazione sull'autenticazione dell'API Looker.

  2. Con questo token temporaneo nell'intestazione dell'autorizzazione, invia una richiesta POST all'API Looker utilizzando il valore user_id dell'utente e includi la sua email nel corpo della richiesta.

    curl -H "Authorization: token ACCESS_TOKEN" -H 'Content-Type: application/json' -X POST -d '{ "email": "example_name@example_email.com" }' https://<instance_name<.api.looker.com/api/4.0/users/{user_id}/credentials_email

  3. Nella pagina Utenti del riquadro Amministrazione, trova l'account utente e fai clic su Modifica.

  4. Fai clic sul pulsante Invia link di reimpostazione. Verrà inviata un'email all'indirizzo email specificato nella richiesta di POST.

Per utilizzare il metodo di accesso alternativo, quando accede a Looker l'utente deve fare clic sul link Accesso alternativo sotto il pulsante Autentica, quindi inserire il proprio nome e il proprio indirizzo email. Possono comunque eseguire l'autenticazione utilizzando le proprie credenziali OAuth, LDAP, SAML o OpenID Connect tramite il pulsante Autentica.

Utilizzare l'SDK dell'API Looker

Anziché seguire i passaggi manuali per effettuare richieste direttamente all'API Looker, puoi utilizzare un SDK fornito da Looker per interagire con l'API in un linguaggio di programmazione di tua scelta. Dopo aver importato l'SDK dell'API Looker e stabilito una connessione client, segui questi passaggi:

  1. Utilizza la funzione create_user_credentials_email(user_id, body), inserendo i valori user_id e body come specificato nella documentazione dell'API Looker. Puoi seguire un esempio simile in questo post della community di Looker sul provisioning automatico degli utenti con l'API Looker.
  2. Una volta aggiornati gli account utente con il metodo SDK, individua l'account utente nella pagina Utenti del riquadro Amministrazione e fai clic su Modifica.
  3. Fai clic sul pulsante Invia link di reimpostazione. Verrà inviata un'email all'indirizzo email specificato nella richiesta di POST.

Per utilizzare il metodo di accesso alternativo, quando l'utente accede a Looker, deve fare clic sul link di accesso alternativo sotto il pulsante Autentica e inserire il proprio nome e indirizzo email. Possono comunque eseguire l'autenticazione utilizzando le proprie credenziali OAuth, LDAP, SAML o OpenID Connect tramite il pulsante Autentica.