En esta página de documentación, se explica cómo configurar tu cliente de OAuth y asociar manualmente las credenciales de OAuth con tu instancia durante su creación.
Cuándo crear credenciales de OAuth
En la mayoría de los casos, Looker (Google Cloud Core) crea y asigna automáticamente credenciales de OAuth administradas por Looker de forma predeterminada. Debes crear un cliente de OAuth y asociar manualmente las credenciales de OAuth personalizadas solo en situaciones específicas, según el tipo de conexión de red y la configuración de autenticación de tu instancia:
- Conexiones privadas o híbridas con OAuth de Google: Se requiere la configuración manual de OAuth siempre que se use OAuth de Google (como autenticación principal o secundaria) con conexiones privadas o híbridas.
- Conexiones públicas con OAuth de Google: Si creas la instancia en la consola deGoogle Cloud , no se requiere la configuración manual de OAuth porque Looker (Google Cloud Core) asigna automáticamente credenciales administradas por Looker de forma predeterminada, aunque puedes configurar credenciales personalizadas de forma opcional. Si creas la instancia con Google Cloud CLI, debes proporcionar credenciales de OAuth.
- Solo para la federación de identidades de personal: No se requiere la configuración manual de OAuth en ningún tipo de conexión de red cuando se usa la federación de identidades de personal sin OAuth de Google secundario.
- Dominios personalizados: Si configuras un dominio personalizado para una instancia que usa conexiones seguras públicas y OAuth de Google, se requieren credenciales de OAuth personalizadas y se configuran como parte del proceso de creación del dominio personalizado.
En la siguiente tabla, se resume cuándo se requiere la configuración manual de las credenciales de OAuth:
| Autenticación principal | Autenticación secundaria | Tipo de conexión de red | Configuración manual de OAuth |
|---|---|---|---|
| OAuth de Google | Ninguno | Conexiones seguras públicas | No es obligatorio si usas la consola de Google Cloud , ya que Looker (Google Cloud Core) asigna automáticamente credenciales administradas por Looker. Es obligatorio si usas gcloud CLI. |
| Conexiones privadas o conexiones híbridas | Obligatorio. Sigue las instrucciones de esta página. | ||
| Federación de identidades de personal | Ninguno | Conexiones públicas | No requerido. |
| Federación de identidades de personal | OAuth de Google | Conexiones seguras públicas | Opcional si usas la consola de Google Cloud . De forma predeterminada, Looker (Google Cloud Core) usa credenciales administradas por Looker, pero puedes proporcionar credenciales personalizadas. Es obligatorio si usas gcloud CLI. |
Roles obligatorios
Para usar la consola de Google Cloud y crear y editar credenciales de OAuth, necesitas los siguientes permisos. (Para ocultar la lista de permisos, contrae la sección Permisos requeridos).
Permisos necesarios
- 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
También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido. Para obtener más información sobre cómo otorgar roles, consulta la página Administra el acceso a proyectos, carpetas y organizaciones en la documentación de Identity and Access Management (IAM).
Antes de crear una instancia de Looker (Google Cloud Core)
Antes de crear una instancia de Looker (Google Cloud Core), completa los pasos que se describen en estas secciones:
- Genera el ID de cliente de OAuth y el secreto de cliente
- Configura la pantalla de consentimiento del usuario, los permisos y los usuarios de prueba
Genera el ID de cliente y el secreto del cliente de OAuth
Primero, crea un cliente de OAuth y genera el ID de cliente y el secreto del cliente para ese cliente. Necesitas estos valores durante la creación de la instancia cuando configuras credenciales de OAuth personalizadas, como para conexiones privadas o híbridas con Google OAuth, o cuando la autenticación de Google está habilitada con gcloud CLI.
Puedes configurar el cliente de OAuth en cualquier proyecto de Google Cloud que desees. No es necesario que sea el mismo proyecto que la instancia de Looker (Google Cloud Core). Sin embargo, la API de Looker (Google Cloud Core) debe estar habilitada en este proyecto.
Para crear el cliente y sus credenciales, sigue estos pasos:
- Navega al proyecto en el que deseas crear el cliente de OAuth.
- Navega a APIs y servicios > Credenciales.
- En la página Credenciales, haz clic en Crear credenciales.
- En el menú desplegable, selecciona ID de cliente de OAuth.
- En el menú desplegable Tipo de aplicación, selecciona Aplicación web.
- En el campo Nombre, ingresa un nombre para tu cliente de OAuth.
- En este punto, no es necesario que agregues URIs en las secciones Orígenes autorizados de JavaScript ni URIs de redireccionamiento autorizados.
- Haz clic en Crear.
Después de hacer clic en Crear, aparecerá la ventana Cliente de OAuth creado. En esta ventana, se muestran el ID de cliente y el secreto del cliente que se crearon para tu cliente de OAuth. Si configuras credenciales de OAuth personalizadas, ingresa estos valores cuando crees tu instancia de Looker (Google Cloud Core) para conexiones seguras públicas, Private Service Connect o acceso privado a servicios.
De manera opcional, haz clic en Descargar JSON para descargar la información de las credenciales en un archivo JSON. Para cerrar la ventana, haz clic en Aceptar.
Configura la pantalla de consentimiento del usuario, los permisos y los usuarios de prueba
A continuación, te recomendamos configurar la pantalla de consentimiento. La pantalla de consentimiento se muestra a un usuario de la instancia de Looker (Google Cloud Core) cuando accede por primera vez y en cualquier momento en que su autorización vence o el usuario la revoca.
Sigue las instrucciones de la página de documentación Configura la pantalla de consentimiento de OAuth y elige permisos. Mientras configuras la pantalla, completa los siguientes parámetros de configuración como se describe:
En la sección Desarrollo de la marca, en Dominios autorizados, el dominio debe coincidir con el dominio de la instancia de Looker (Google Cloud core) que usa las credenciales de OAuth. Si vas a crear un dominio personalizado para tu instancia de Looker (Google Cloud Core) y conoces el dominio que le asignarás, puedes ingresarlo ahora. De lo contrario, puedes dejar este campo vacío. Se completará automáticamente cuando agregues el URI de redireccionamiento autorizado después de que se cree la instancia de Looker (Google Cloud Core).
En la sección Público, en Tipo de usuario, selecciona una de las siguientes opciones:
- Interno: Este es el parámetro de configuración predeterminado. Solo los usuarios de tu organización pueden acceder a la instancia una vez que se agregan a través de IAM.
- Hacer externa: Los usuarios con cualquier tipo de Cuenta de Google pueden acceder a la instancia una vez que se los agrega a través de IAM.
Durante la creación de la instancia de Looker (Google Cloud Core)
Algunas instancias requieren credenciales de OAuth personalizadas, como las instancias con conexiones privadas o híbridas y OAuth de Google, o las instancias que creas con gcloud CLI mientras la autenticación de Google está habilitada. En estos casos, ingresa el ID de cliente de OAuth y el secreto del cliente durante la configuración. Para encontrar estos valores, selecciona tu cliente de OAuth en la consola de Google Cloud .
Según el tipo de conexión y el método de creación, ingresa las credenciales de la siguiente manera:
- Para Private Service Connect o para instancias de conexiones públicas que usan credenciales de OAuth manuales opcionales, en la consola de Google Cloud , ingresa los valores en la sección Credenciales de la aplicación de OAuth.
- En gcloud CLI, pasa las marcas
--oauth-client-idy--oauth-client-secretal comandogcloud looker instances create, como se describe en las guías de creación para conexiones seguras públicas, Private Service Connect o acceso privado a servicios.
Después de crear una instancia de Looker (Google Cloud Core)
Sigue estas instrucciones para completar la configuración. Cuando agregues un URI de redireccionamiento autorizado, se agregará a tu pantalla de consentimiento de OAuth como un dominio autorizado.
Agrega el URI de redireccionamiento autorizado al cliente de OAuth
Si aún no lo hiciste, sigue estos pasos para ingresar la URL de la instancia de Looker (Google Cloud Core) recién creada en el cliente de OAuth.
Después de crear una instancia de Looker (Google Cloud Core), busca y copia la URL de la instancia. Puedes encontrar la URL en la página Instancias.
En la consola de Google Cloud , navega a APIs y servicios > Credenciales.
En el encabezado IDs de cliente de OAuth 2.0, haz clic en el nombre del cliente que creaste.
En la sección URI de redireccionamiento autorizados, haz clic en Agregar URI.
Pega la URL de la instancia de Looker (Google Cloud Core) en el campo URIs. Agrega
/oauth2callbackal final de la URL. Por ejemplo:https://uuid.looker.app/oauth2callback.Si vas a configurar la autorización de OAuth para BigQuery, también puedes agregar un segundo URI de redireccionamiento que apunte a la URL de la instancia de Looker (Google Cloud Core) seguida de
/external_oauth/redirectagregada al final de la URL. Por ejemplo:https://uuid.looker.app/external_oauth/redirect.Haz clic en Guardar.
La actualización puede tardar entre cinco minutos y algunas horas en aplicarse.
Administra usuarios
Una vez que se configure el cliente de OAuth y se cree la instancia de Looker (Google Cloud Core), podrás acceder a ella con OAuth. Luego, puedes elegir el método de autenticación para tu instancia.
Si usas OAuth como método de autenticación principal, completa los pasos que se describen en la página de documentación Usa Google OAuth para la autenticación de usuarios de Looker (Google Cloud core) para completar la configuración de OAuth para la autenticación de usuarios.
Una vez que hayas configurado el método de autenticación, podrás agregar o quitar usuarios a través de tu proveedor de identidad y administrarlos en Looker.
Consulta el tipo de credenciales de OAuth de tu instancia
Las credenciales de OAuth no se indican directamente en la página de configuración de la instancia de la consola de Google Cloud . Haz clic en Editar en la página de configuración de la instancia para ver la sección Credenciales de la aplicación de OAuth.
Si las credenciales de OAuth se configuran como Administradas por Looker, Looker (Google Cloud Core) asigna credenciales de OAuth administradas por Looker para tu instancia durante su creación, y no se muestran el ID de cliente ni el secreto del cliente.
Si las credenciales de OAuth se establecen en Manual, se agregaron credenciales de OAuth manuales a tu instancia durante o después de su creación. No se muestran el ID de cliente ni el secreto del cliente. En su lugar, la sección muestra marcadores de posición ****.
Edita el cliente de OAuth para una instancia de Looker (Google Cloud Core)
Si lo deseas, puedes agregar, editar o cambiar las credenciales de OAuth de tu instancia de Looker (Google Cloud Core) siguiendo estos pasos:
- Configura el cliente o las credenciales nuevos.
- En la consola de Google Cloud , en la página Instancias, haz clic en el nombre de una instancia para abrir la página DETALLES.
- En la página DETALLES, haz clic en Editar.
- En la página Editar instancia de Looker (Google Cloud Core), navega a la sección Credenciales de la aplicación de OAuth y selecciona Manual, si aún no está seleccionada.
- Ingresa los valores nuevos en los campos ID de cliente de OAuth y Secreto de cliente de OAuth.
- Haz clic en Guardar.
Si las credenciales de tu aplicación de OAuth están configuradas como Administradas por Looker, no puedes agregar ni editar credenciales. Cambia al parámetro de configuración Manual para editar o agregar credenciales.
¿Qué sigue?
- Crea una instancia de Looker (Google Cloud Core) con IP pública
- Crea una instancia de Looker (Google Cloud Core) con conexiones privadas (acceso privado a servicios)