Cómo habilitar la opción de acceso alternativo

Looker puede autenticar usuarios mediante uno de varios tipos de servidores de autenticación, como Google OAuth, LDAP, SAML y OpenID Connect. Si habilitas cualquiera de estos métodos de autenticación, se inhabilitarán otros sistemas de autenticación, como el correo electrónico y la contraseña.

Los administradores de Looker pueden ofrecer a un usuario una opción de acceso alternativa que utilice su dirección de correo electrónico si tiene la función de administrador o el permiso login_special_email.

Habilita el acceso alternativo en la instancia de Looker

Antes de habilitar la opción de acceso alternativa para un usuario, la instancia de Looker debe configurarse para aceptar credenciales de correo electrónico:

  1. Navegue a la sección Autenticación del panel Administrador y seleccione el tipo de autenticación habilitado actualmente: Google OAuth, LDAP, SAML o OpenID Connect.
  2. En la sección Opciones de migración, habilita el botón de activación Acceso alternativo para administradores y usuarios especificados.

Otorga permiso al usuario para usar el acceso alternativo

Solo los usuarios con la función de administrador o el permiso de login_special_email pueden usar un acceso alternativo. Una forma de otorgar el permiso login_special_email a un usuario no administrador es crear una función nueva que contenga ese permiso y, luego, asignar esa función al usuario, de la siguiente manera:

  1. Navegue a la página Funciones, ubicada en la sección Usuarios del panel Administrador.
  2. Haz clic en el botón Nuevo conjunto de permisos.
  3. Ingresa un nombre para el nuevo conjunto de permisos, por ejemplo, Acceso alternativo.
  4. Selecciona la casilla con el nombre login_special_email.
  5. Haz clic en Nuevo conjunto de permisos.
  6. Haz clic en Rol nuevo.
  7. Ingresa un nombre para la función nueva, por ejemplo, Función de acceso alternativo.
  8. En la lista Conjunto de permisos, selecciona el conjunto de permisos nuevo de la lista.
  9. En la lista Model Set, selecciona All.
  10. En la lista Usuarios, selecciona el usuario al que se le otorgará el permiso de acceso alternativo.
  11. Haz clic en el botón Función nueva para guardar la función nueva.
  12. Haz clic en Confirmar.

Crear credenciales de correo electrónico para el usuario

Una vez que se haya otorgado permiso al usuario para usar las credenciales de correo electrónico, el siguiente paso es crearlas. Para crear credenciales de correo electrónico, un administrador de Looker puede usar la API de Looker para realizar una solicitud POST o usar el SDK de la API de Looker en el lenguaje de programación que prefiera el administrador.

Realiza una solicitud POST a la API de Looker

Debido a su naturaleza manual, este es un mejor método de uso cuando solo tiene una cantidad limitada de usuarios para los que desea configurar la opción de acceso alternativo.

En este ejemplo, se usa un comando curl para realizar una solicitud POST al extremo de API de create_user_credentials_email mediante un token de acceso temporal:

  1. Para generar el token temporal (ACCESS_TOKEN), siga las instrucciones de Autenticación sin un SDK en la página de documentación de Autenticación de API de Looker.

  2. Con este token temporal en el encabezado de autorización, envía una solicitud POST a la API de Looker con user_id del usuario y agrega su correo electrónico en el cuerpo de la solicitud.

    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. En la página Usuarios del panel Administrador, busca la cuenta de usuario y haz clic en Editar.

  4. Haga clic en el botón Enviar vínculo de restablecimiento. Se enviará un correo electrónico a la dirección que especificaste en tu solicitud de POST.

Para usar el método de acceso alternativo, cuando el usuario acceda a Looker, deberá hacer clic en el vínculo Acceso alternativo que se encuentra debajo del botón Autenticar y, luego, ingresar su nombre y dirección de correo electrónico. Pueden seguir autenticándose con sus credenciales de OAuth, LDAP, SAML o OpenID Connect mediante el botón Authenticate.

Usa el SDK de la API de Looker

En lugar de seguir los pasos manuales para realizar solicitudes directamente a la API de Looker, puedes usar un SDK proporcionado por Looker para interactuar con la API en el lenguaje de programación que elijas. Después de importar el SDK de la API de Looker y establecer una conexión con el cliente, sigue estos pasos:

  1. Usa la función create_user_credentials_email(user_id, body) insertando user_id y body como se especifica en la documentación de la API de Looker. Puedes seguir un ejemplo similar de esta publicación de Comunidad de Looker sobre el aprovisionamiento automático de usuarios con la API de Looker.
  2. Una vez que las cuentas de usuario se hayan actualizado con el método del SDK, en la página Usuarios del panel Administrador, busque la cuenta de usuario y haga clic en Editar.
  3. Haga clic en el botón Enviar vínculo de restablecimiento. Se enviará un correo electrónico a la dirección que especificaste en tu solicitud de POST.

Para usar el método de acceso alternativo, cuando el usuario acceda a Looker, deberá hacer clic en el vínculo de acceso alternativo debajo del botón Authenticate y, luego, ingresar su nombre y dirección de correo electrónico. Pueden seguir autenticándose con sus credenciales de OAuth, LDAP, SAML o OpenID Connect mediante el botón Authenticate.