Cómo habilitar la opción de acceso alternativo

Looker puede autenticar usuarios a través de uno de varios tipos de servidores de autenticación, como LDAP, SAML o OAuth de Google. 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 pueden darles a los usuarios una opción de acceso alternativa que utilice su dirección de correo electrónico si tienen un rol de administrador o permisos login_special_email.

Paso 1: Habilita el acceso alternativo en la instancia de Looker

Primero, la instancia de Looker debe estar configurada para aceptar credenciales de correo electrónico. Si deseas configurar Looker para que acepte credenciales de correo electrónico, sigue estos pasos:

  1. Ve a la pestaña Authentication del panel Admin y selecciona el tipo de autenticación actualmente habilitado. Algunos ejemplos incluyen LDAP, SAML y Google OAuth.
  2. Habilita el interruptor Acceso alternativo para administradores y usuarios especificados en la sección Opciones de migración.

Paso 2: Otórgale permiso al usuario para usar el acceso alternativo

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

  1. Navega a la página Roles, que se encuentra en la pestaña Users del panel Admin.
  2. Haz clic en el botón Nuevo conjunto de permisos ubicado en la parte superior de la página.
  3. Ingresa un nombre para el nuevo conjunto de permisos; por ejemplo, "Acceso alternativo".
  4. Marca la casilla con la etiqueta login_special_email.
  5. Haz clic en el botón Guardar en la parte inferior de la página.
  6. Haz clic en el botón Nuevo rol en la parte superior de la página.
  7. Ingresa un nombre para la función nueva; por ejemplo, "Función de acceso alternativo".
  8. En la sección Conjunto de permisos, selecciona tu nuevo conjunto de permisos de la lista.
  9. En la sección Conjunto de modelos, selecciona Todos.
  10. En la sección Usuarios, selecciona el usuario al que se le debe otorgar el permiso de acceso alternativo.
  11. Haz clic en el botón Nuevo rol en la parte inferior de la página para guardar el rol nuevo.
  12. Haz clic en el botón Confirmar en el cuadro de diálogo emergente.

Paso 3: Crea credenciales de correo electrónico para el usuario

Ahora que el usuario está habilitado para usar credenciales de correo electrónico, estas se deben crear. Para crear estas credenciales, un administrador de Looker puede usar la API de Looker para hacer una solicitud POST o el SDK de la API de Looker en el lenguaje de programación que elija el administrador.

Opción 1: Realiza una solicitud POST a la API de Looker

Debido a su naturaleza manual, este es un método más adecuado cuando tienes una cantidad limitada de usuarios para los que deseas 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), sigue los pasos que se indican en la página de documentación de Autenticación de API en la sección Autenticación sin un SDK.
  2. Con este token temporal en el encabezado de autorización, envía una solicitud POST a la API de Looker con el user_id del usuario y, luego, incluye 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/3.1/users/{user_id}/credentials_email
  3. En la página Usuarios de la sección Administrador, busca la cuenta de usuario y haz clic en Editar.
  4. Haz clic en el botón Enviar vínculo de restablecimiento. Se enviará un correo electrónico a la dirección que especificaste en la solicitud POST.

Para usar el método de acceso alternativo, cuando el usuario acceda a Looker, deberá hacer clic en el vínculo Acceso alternativo y, luego, ingresar su nombre y dirección de correo electrónico. De todos modos, podrán autenticarse con sus credenciales SAML, OAuth o LDAP con el botón Autenticar.

Opción 2: Usa el SDK de la API de Looker

En lugar de seguir los pasos manuales para hacer 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 quieras. 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) e inserta 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 cómo aprovisionar usuarios automáticamente con la API de Looker.
  2. Una vez que se hayan actualizado las cuentas de usuario con el método SDK, en la página Usuarios de la sección Administrador, busca la cuenta de usuario y haz clic en Editar.
  3. Haz clic en el botón Enviar vínculo de restablecimiento. Se enviará un correo electrónico a la dirección que especificaste en la solicitud POST.

Para usar el método de acceso alternativo, cuando el usuario acceda a Looker, deberá hacer clic en el vínculo Acceso alternativo y, luego, ingresar su nombre y dirección de correo electrónico. De todos modos, podrán autenticarse con sus credenciales SAML, OAuth o LDAP con el botón Autenticar.