Configuración del administrador: autenticación de Google

La página Autenticación de Google en la sección Autenticación del menú Administrador te permite configurar OAuth de Google en Looker.

Descripción general de las funciones

Looker puede realizar la autenticación con OAuth de Google para los usuarios que tienen cuentas registradas en Google Workspace.

  • Las organizaciones que usan Google Workspace pueden autenticar a los usuarios de Looker que tienen Cuentas de Google.
  • Los usuarios acceden a Looker autenticándose con su Cuenta de Google.
  • Las Cuentas de Google nuevas obtienen acceso a Looker automáticamente. No es necesario invitar a los usuarios a Looker por separado. Estableces el rol predeterminado para los usuarios nuevos, lo que puede limitar su acceso a las funciones y los datos.
  • Las organizaciones pueden configurar la duplicación de Grupos de Google para asignar automáticamente roles y grupos de Looker en función de la pertenencia a Grupos de Google.
  • Cuando se habilita, Looker autentica a los usuarios solo con OAuth de Google, a menos que se seleccione la opción "acceso alternativo" (consulta la siguiente sección sobre Cómo habilitar los accesos con correo electrónico mientras la autenticación de Google está habilitada).
  • El avatar de Google de un usuario aparece en la barra de navegación en lugar del símbolo de usuario estándar.
  • Cuando se habilita OAuth de Google, la instancia de Looker puede combinar las cuentas de usuario existentes con el dominio registrado en Google, pero solo para las cuentas cuya dirección de correo electrónico coincida con el dominio. Todas las demás cuentas que no sean de administrador perderán la capacidad de acceder.
  • Todos los usuarios del dominio especificado obtienen acceso a la instancia de Looker.
  • Los permisos para los usuarios nuevos de Google se establecen de forma predeterminada en el acceso básico para una lista especificada de modelos (que, de manera opcional, podría ser el acceso a cero modelos). Un administrador puede actualizar los permisos después de crear la cuenta.
  • Las cuentas de Looker nuevas que se autentican con OAuth de Google no pueden cambiar a la autenticación con contraseña, incluso si OAuth está inhabilitado para la instancia de Looker.

Requisitos preliminares

Para usar Google OAuth, se requiere lo siguiente:

Para usar la replicación de Grupos de Google, se aplican los siguientes requisitos adicionales:

  • En el proyecto de Google Cloud que contiene tu cliente de OAuth, se debe habilitar la API de Cloud Identity (cloudidentity.googleapis.com).
  • En el caso de las instancias de Looker alojadas por el cliente, el host de la instancia debe tener acceso a Internet saliente a través de HTTPS (cloudidentity.googleapis.com:443).
  • Los usuarios deben tener el permiso VIEW_MEMBERSHIP en los Grupos de Google a los que pertenecen. En la configuración de Grupos de Google, establece el campo Quién puede ver los miembros en Miembros del grupo.
  • La duplicación de Grupos de Google no es compatible con las instancias de Looker que están en modo compatible con FIPS.

Habilita la autenticación con Google OAuth

Para habilitar la autenticación con Google OAuth, un administrador debe realizar pasos tanto en Google como en Looker, como se describe en las siguientes secciones.

Configuración en Google

En esta sección, se describen los pasos para habilitar Google OAuth en Google. La descripción genérica de estos pasos se encuentra en la página de Atención al cliente de Google sobre cómo configurar OAuth 2.0. También puedes consultar la documentación de la Ayuda de la consola deGoogle Cloud .

  1. Ve a la consola deGoogle Cloud .

  2. Haz clic en la flecha hacia abajo en el menú desplegable Seleccionar un proyecto. Es posible que veas el nombre de un proyecto existente en el menú desplegable. De todos modos, haz clic en la flecha hacia abajo para acceder a la opción de crear un proyecto nuevo.

  3. En la página Selecciona un proyecto, haz clic en Proyecto nuevo.

    La consola de Google Cloud muestra la página Proyecto nuevo.

  4. Completa la información en la página Proyecto nuevo y haz clic en Crear.

    Cuando la consola de Google Cloud termine de crear tu proyecto nuevo, Google te devolverá a la consola de Google Cloud y mostrará tu proyecto nuevo.

  5. Opcional: Si planeas usar la duplicación de Grupos de Google, habilita la API de Cloud Identity en tu proyecto de Google Cloud . Si habilitas esta API, el permiso https://www.googleapis.com/auth/cloud-identity.groups.readonly será visible cuando configures la pantalla de consentimiento de OAuth. Debes tener el rol de Identity and Access Management (IAM) de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin) para habilitar las APIs.

    Habilitar la API

  6. En el menú de la izquierda, selecciona APIs y servicios > Credenciales.

  7. En la página Credenciales, haz clic en el botón Crear credenciales y selecciona ID de cliente de OAuth en el menú desplegable.

    En la consola de Google Cloud , se muestra la página Crear ID de cliente de OAuth.

  8. La consola de Google Cloud requiere que configures una pantalla de consentimiento de OAuth, que permite a los usuarios elegir cómo otorgar acceso a sus datos privados y proporciona un vínculo a las condiciones del servicio y la política de privacidad de tu organización. Haz clic en Configurar pantalla de consentimiento. (Si ya configuraste el consentimiento de OAuth para un proyecto anterior, no verás esta opción y podrás avanzar al paso 13).

    En la consola de Google Cloud , se muestra la página Pantalla de consentimiento de OAuth.

  9. Ingresa el dominio de tu instancia de Looker en el campo Dominios autorizados. Por ejemplo, si Looker aloja tu instancia en https://mycompany.looker.com, el dominio es looker.com. En el caso de las implementaciones de Looker alojadas por el cliente, ingresa el dominio en el que alojas Looker.

  10. Configura la pantalla de consentimiento de OAuth y haz clic en Guardar y continuar.

  11. En la página Permisos, configura los permisos de la siguiente manera:

    • Si planeas usar la duplicación de Grupos de Google, haz clic en Agregar o quitar permisos. Busca el permiso https://www.googleapis.com/auth/cloud-identity.groups.readonly, selecciona la casilla de verificación junto a él y haz clic en Actualizar. Si no ves este permiso, verifica que hayas habilitado la API de Cloud Identity en tu proyecto deGoogle Cloud .
    • Si no planeas usar la duplicación de Grupos de Google, no se requiere ninguna configuración de permisos adicional.

    Haz clic en Guardar y continuar.

  12. En la página Resumen, haz clic en Volver al panel.

    La consola de Google Cloud te devuelve a la página Crear ID de cliente de OAuth.

  13. En Tipo de aplicación, selecciona Aplicación web.

  14. En el campo Nombre, ingresa un nombre para tu ID de cliente de OAuth.

  15. En el campo Orígenes autorizados de JavaScript, ingresa la URL de tu instancia de Looker, incluido el https://. Por ejemplo:

    • Si Looker aloja tu instancia, haz lo siguiente: https://mycompany.looker.com
    • Si tienes una instancia de Looker alojada por el cliente: https://looker.mycompany.com
    • Si tu instancia de Looker requiere un número de puerto: https://looker.mycompany.com:9999
  16. En el campo URI de redireccionamiento autorizados, ingresa la URL de tu instancia de Looker, seguida de /oauth2callback. Por ejemplo: https://mycompany.looker.com/oauth2callback o https://looker.mycompany.com:9999/oauth2callback.

  17. Haz clic en Crear.

  18. Copia los valores de tu ID de cliente y tu secreto del cliente, ya que los necesitarás para configurar Looker.

Configuración en Looker

Para habilitar OAuth de Google en Looker, sigue estos pasos.

  1. En la aplicación de Looker, mientras accedes como administrador, haz clic en el menú desplegable Administrador para abrir el menú Administrador.

  2. En el grupo Autenticación, haz clic en Google. Looker muestra la página Autenticación de Google.

  3. Haz clic en Habilitado para mostrar y editar la configuración de OAuth de Google. (Esto no habilita de inmediato la autenticación de Google; debes confirmar tu elección más adelante).

  4. Ingresa la configuración de Google Auth.

    • ID de cliente y secreto del cliente: Copia y pega estos valores de la página Cliente de OAuth de Google, como se indica en las instrucciones de configuración de Google anteriores.
    • Dominios: Son los nombres de dominio administrados por Google de tu organización. Cualquier usuario de Google en el dominio determinado puede acceder a tu instancia de Looker. Si controlas varios dominios de Google, puedes ingresarlos separados por comas.
  5. Ingresa las Opciones de migración, que controlan el comportamiento de la instancia de Looker durante la transición a OAuth de Google.

    • Acceso alternativo para administradores y usuarios especificados: Permite que los administradores y los usuarios especificados sigan accediendo con correo electrónico y contraseña. Este parámetro de configuración habilita un método de resguardo crítico para evitar un bloqueo completo si se borra o inhabilita el proyecto de Google Cloud que aloja el cliente de OAuth de Looker (lo que puede provocar un error 401 deleted_client incluso después de restablecer el proyecto) o si falla OAuth de Google por otros motivos. Este parámetro de configuración es muy recomendable y se describe con más detalle en Habilita los accesos por correo electrónico mientras la autenticación de Google está habilitada.
    • Combinar usuarios con: Convierte a los usuarios existentes que tienen direcciones de correo electrónico en los dominios especificados para que usen OAuth de Google en su próximo acceso (como Correo electrónico/contraseña de Looker). Se recomienda este parámetro de configuración.
    • Roles para usuarios nuevos: Especifica la funcionalidad y el acceso al modelo que tienen los usuarios nuevos que no son administradores. Esta lista se puede actualizar más adelante. Si se deja en blanco, los usuarios nuevos autenticados por Google tendrán una funcionalidad limitada dentro de la plataforma de Looker hasta que un administrador agregue un rol a su cuenta. Como todos los usuarios de tu dominio de Google podrán acceder a Looker, considera especificar un rol predeterminado para los usuarios nuevos que limite el acceso de forma adecuada.
  6. Configura Grupos y roles para duplicar de forma opcional los Grupos de Google en grupos de Looker y asignar roles automáticamente:

    Si tienes Grupos de Google administrados, Looker puede crear grupos de Looker que reflejen la membresía de tus Grupos de Google, lo que significa que no tienes que configurar usuarios en Looker directamente, sino que puedes administrar el acceso de los usuarios administrando la membresía de los Grupos de Google. Además, puedes usar los grupos de Looker para asignar roles a los miembros del grupo, establecer controles de acceso al contenido, controlar el acceso a las funciones y los datos, y asignar atributos de usuario.

    Para que la duplicación de grupos funcione correctamente, los usuarios deben tener el permiso VIEW_MEMBERSHIP en los Grupos de Google a los que pertenecen, lo que permite que Looker verifique sus membresías de grupo cuando acceden. Para otorgar este permiso en la configuración de Grupos de Google, establece el campo Quién puede ver los miembros en Miembros del grupo.

    Para habilitar la duplicación de grupos, sigue estos pasos:

    1. Activa el botón de activación Duplicar Grupos de Google.
    2. Haz clic en Administrar grupos para abrir la configuración de asignación de grupos.
    3. Completa los siguientes campos para cada Grupo de Google que quieras replicar:
      • Nombre del grupo de Looker: Ingresa un nombre para el grupo de Looker. Este nombre aparece en la página Grupos de Looker.
      • ID del Grupo de Google: Ingresa el nombre o la dirección de correo electrónico del Grupo de Google que deseas duplicar.
      • Roles: Selecciona uno o más roles de Looker para asignarlos a los miembros del grupo.

    Looker crea un grupo de Looker para cada Grupo de Google que agregues a la configuración. Puedes ver esos grupos en la página Grupos de Looker.

    Looker aplica los grupos de Looker duplicados (y cualquier rol y acceso asociados) cuando los usuarios acceden a la instancia de Looker. Los cambios en las membresías de los Grupos de Google se actualizan cuando cada usuario vuelve a acceder.

Replicar Grupos de Google

Después de configurar la duplicación de Grupos de Google, puedes editar o inhabilitar los grupos duplicados, y configurar opciones avanzadas de administración de roles, como se describe en las siguientes secciones.

Cómo editar grupos duplicados

Cuando realizas cambios en la membresía de un grupo de Google, esos cambios se propagan automáticamente a la membresía del grupo de Looker duplicado y se validan en el momento del próximo acceso de cada usuario.

Si editas el nombre del grupo de Looker o el rol asignado a un grupo en la página Autenticación de Google, cambiará la forma en que aparece el grupo duplicado en la página Grupos o los roles asignados al grupo, pero no cambiarán los miembros del grupo.

Si cambias el nombre o el correo electrónico en el campo ID del Grupo de Google por un ID de Grupo de Google nuevo, se cambiarán los miembros del grupo de Looker duplicado por los miembros del nuevo Grupo de Google, mientras que se mantendrán el nombre del grupo y los roles definidos en la página Autenticación de Google.

Looker aplica las ediciones que realices en un grupo duplicado a los usuarios de ese grupo la próxima vez que accedan a Looker.

Inhabilita los grupos duplicados

Si quieres dejar de duplicar tus Grupos de Google en Looker, desactiva el botón de activación Duplicar Grupos de Google en la página Autenticación de Google. Inhabilitar el botón de activación genera el siguiente comportamiento:

  • Cualquier Grupo de Google duplicado que no tenga usuarios se borra de inmediato.
  • Cualquier grupo de Google duplicado que contenga usuarios se marcará como huérfano. Ya no se pueden agregar ni quitar usuarios de los grupos huérfanos. Si ningún usuario de un grupo huérfano accede en un plazo de 31 días, se borrará el grupo.

Administración avanzada de roles

Si el botón de activación Duplicar Grupos de Google está habilitado, la sección Administración avanzada de roles muestra opciones que determinan con qué rigurosidad los administradores de Looker pueden configurar los grupos y usuarios de Looker que se duplicaron de Google.

Si quieres que la configuración de usuarios y grupos de Looker coincida estrictamente con la de Grupos de Google, selecciona todas las opciones de Administración avanzada de roles. Cuando se habilitan todas las opciones, los administradores de Looker no pueden modificar las membresías de los grupos duplicados directamente y solo pueden asignar roles a los usuarios a través de Grupos de Google.

Si quieres tener más flexibilidad para personalizar los grupos en Looker, deja estas opciones sin seleccionar. Tus grupos de Looker seguirán reflejando la configuración de tus Grupos de Google, pero podrás realizar tareas adicionales de administración de grupos y usuarios en Looker, como agregar usuarios de Google a grupos integrados de Looker o asignar roles directamente a usuarios de Google.

La sección Administración avanzada de roles contiene las siguientes opciones:

  • Impedir que los usuarios individuales de Google reciban roles directos: Si activas esta opción, los administradores de Looker no podrán asignar roles de Looker directamente a los usuarios de Google. Los usuarios de Google reciben roles solo a través de sus membresías de grupo. Si se permite que los usuarios de Google sean miembros de grupos de Looker integrados (no replicados), aún pueden heredar roles de los Grupos de Google replicados y de los grupos de Looker integrados. A los usuarios de Google a los que se les asignaron roles directamente se les quitarán esos roles la próxima vez que accedan.

  • Impedir la pertenencia directa a grupos que no pertenecen a Google: Esta opción impide que los administradores de Looker agreguen miembros de grupos duplicados directamente a grupos integrados de Looker que no forman parte de la configuración del grupo duplicado en la página Autenticación de Google.

    Si se selecciona esta opción, los usuarios de Google que se asignaron anteriormente a grupos integrados de Looker se quitarán de esos grupos cuando vuelvan a acceder.

    Si se desmarca esta opción, los administradores de Looker podrán agregar usuarios de Google directamente a los grupos integrados de Looker.

  • Impedir la herencia de roles de grupos que no son de Google: Esta opción impide que los miembros de grupos duplicados hereden roles de grupos integrados de Looker. Si se permite que los Grupos de Google replicados sean miembros de grupos integrados de Looker, los usuarios de Google pueden conservar la membresía en los grupos integrados de Looker, pero los usuarios de Google que antes heredaban roles de un grupo integrado perderán esos roles la próxima vez que accedan.

    Si se desmarca esta opción, los grupos duplicados o los usuarios de Google que se agreguen como miembros de un grupo integrado de Looker heredarán los roles asignados a ese grupo integrado.

  • La autenticación requiere un rol: Si esta opción está activada, los usuarios de Google deben tener un rol de Looker asignado. Si esta opción está activada, Looker requiere que los usuarios de Google tengan un rol de Looker asignado para poder acceder a Looker.

    Si se desmarca esta opción, los usuarios de Google podrán autenticarse en Looker incluso si no tienen un rol asignado. Un usuario sin un rol asignado no podrá ver datos ni realizar acciones en Looker, pero podrá acceder.

Probar la autenticación de usuarios

  1. Haz clic en Probar la autenticación de Google para usar la configuración actual y tratar de autenticar el navegador actual en una ventana nueva. Esta acción no guarda la configuración actual ni la aplica a la instancia de Looker.

    Si no accediste a Google, se te solicitará que lo hagas y que otorgues tu consentimiento para usar la información de tu Cuenta de Google. Este flujo usa la configuración personalizada de la pantalla de consentimiento que usaste en la configuración del lado de Google.

    Si se realiza correctamente, se mostrará una sección Información del usuario con tu nombre, correo electrónico y dominio, junto con los Grupos de Google duplicados que se detecten para tu cuenta. La presencia de esta sección Información del usuario muestra que Looker autenticaría correctamente a este usuario.

    Si se produce un error, aparecerán descripciones de este. Estos son algunos problemas comunes:

    • Se copió de forma incorrecta el ID de cliente o el secreto del cliente. Estos se deben copiar y pegar con cuidado en su totalidad.
    • El usuario está fuera del dominio. Si ves una sección Información personal, pero no User Info, es probable que el usuario no esté en el dominio que especificaste. Esto indica que la persona se autenticó correctamente en Google, pero no está usando una Cuenta de Google que hayas elegido para permitir el acceso a tu instancia de Looker.
    • Una URL de Looker o de redireccionamiento no está configurada correctamente en Google para tu instancia de Looker.
    • Si los Grupos de Google no se cargan, verifica que la API de Cloud Identity esté habilitada en tu proyecto de Google Cloud , que se haya agregado el permiso de https://www.googleapis.com/auth/cloud-identity.groups.readonly y que el usuario tenga permisos de VIEW_MEMBERSHIP en sus Grupos de Google.
  2. Para guardar y aplicar los cambios, selecciona Confirmé la configuración anterior y quiero habilitar su aplicación global. Haz clic en Actualizar.

Configura la autenticación de Google con la API

Los administradores pueden leer y actualizar la configuración de autenticación de Google y las asignaciones de roles de grupo de forma programática con los extremos google_config de la API de Looker. Para obtener más información, consulta la referencia de la API de Looker.

Sugerencias

  • Para experimentar con el ciclo de autenticación completo, puedes salir de Google y ver que Google te solicita que vuelvas a acceder cuando intentas acceder a Looker.

  • En Google, puedes hacer clic en Cuenta en el menú desplegable personal (junto a tu dirección de correo electrónico en la parte superior derecha de una página de Google Workspace) para administrar tu cuenta personal.

    En esa página de administración, hay una pestaña Seguridad con una sección Permisos de la cuenta. Si haces clic en Apps y sitios web Ver todo, podrás (como usuario) ver y administrar los servicios y las apps a los que les otorgaste permisos.

    Si haces clic en los permisos de Looker que otorgaste para acceder, se mostrarán los detalles que los usuarios ven en la pantalla de consentimiento que personalizaste anteriormente. También puedes hacer clic en Revocar acceso para que la próxima vez que accedas a Looker (o pruebes la autorización) se te vuelva a mostrar la pantalla de consentimiento. Puedes usar este flujo de trabajo para personalizar la pantalla de consentimiento y ver lo que verán los usuarios.

Soluciona problemas

Para solucionar problemas de autenticación, consulta el panel de actividad del usuario en Actividad del sistema. Este panel tiene tarjetas que muestran los errores de acceso recientes y, además, incluye el método de autenticación que se usó, el mensaje de error que se devolvió y la hora del intento.

  • Si falla el intento de acceso de un usuario, primero asegúrate de que tenga un nombre y un apellido en su Cuenta de Google. Si el usuario borró su nombre o apellido de su Cuenta de Google, es posible que Looker no pueda autenticarlo con OAuth de Google.

  • Si el intento de acceso de un usuario falla y Looker muestra un error como User not in the authorized domain, verifica el campo hd de la respuesta JSON. Si el campo hd contiene un dominio, asegúrate de que esté registrado en tu cuenta de Google Workspace. Si el campo hd está vacío, usa la Herramienta para transferir usuarios no administrados para invitar al usuario a convertir su cuenta en una cuenta administrada dentro de tu dominio.

  • Si el intento de acceso de un usuario falla, pero Looker no muestra un mensaje de error, es posible que el usuario haya editado el nombre de su cuenta de Google Workspace y borrado su nombre o apellido. En esta situación, es posible que el nombre de la cuenta de Google Workspace de Google siga apareciendo completo en la Consola del administrador, que tal vez no muestre las ediciones del usuario. Para evitar este problema, los administradores de Google Workspace pueden inhabilitar la opción Permitir que los usuarios personalicen este parámetro de configuración.

  • Si la autenticación de Google devuelve un error 401 deleted_client, este error indica que se borró o inhabilitó el proyecto de Google Cloud que aloja el cliente de OAuth de Looker. Incluso si el proyecto de Google Cloud se restablece posteriormente, es posible que el cliente de OAuth siga fallando con el error deleted_client, lo que provocará un bloqueo completo del acceso para todos los usuarios. Si la autenticación de Google es el único método de autenticación habilitado, este bloqueo impide el acceso incluso para los administradores.

    Para evitar el bloqueo completo en caso de que se borre o falle un cliente de OAuth, debes habilitar el parámetro de configuración Acceso alternativo para administradores. Este parámetro de configuración garantiza que los administradores tengan un método de acceso de resguardo para acceder a la instancia de Looker y actualizar la configuración de autenticación.

Habilita los accesos por correo electrónico mientras la autenticación de Google está habilitada

Las Cuentas de Google nuevas obtienen acceso a Looker automáticamente, por lo que no es necesario agregar usuarios que estén en tu dominio de Google.

Para agregar un usuario con una dirección de correo electrónico que no esté en tu dominio de Google, sigue estos pasos:

  1. Habilita la opción Acceso alternativo para administradores y usuarios especificados en la página de autenticación de Google.
  2. Crea o modifica un rol del usuario existente para agregar el permiso login_special_email
  3. Ve a Agregar usuarios en el panel de usuarios (/admin/users/new).
  4. Agrega las direcciones de correo electrónico que quieras incluir y los roles que deben tener esos usuarios, que deben incluir un rol con el permiso login_special_email.
  5. Esos usuarios ahora pueden acceder con https://mycompany.looker.com/login/email (URL oculta).

Inhabilitar la autenticación de Google una vez que se habilitó

Si quieres inhabilitar la autenticación de Google para tu instancia de Looker después de que ya se haya habilitado, debes tener en cuenta lo siguiente:

  • Los usuarios que se crearon antes de que se agregara la autenticación de Google y que ya configuraron un acceso normal con correo electrónico y contraseña seguirán funcionando.
  • Los usuarios que se crearon después de que se agregó la autenticación de Google ya no podrán acceder. Si bien sus cuentas siguen existiendo, no tienen forma de acceder a ellas y, de hecho, quedan huérfanas.

Por eso, te sugerimos que evites esta ruta. Si debes seguir este camino, es posible que haya un método para corregir las cuentas huérfanas con la API de Looker. Comunícate con el equipo de asistencia de Looker para obtener más orientación.