En esta página, se explica cómo configurar la incorporación privada. La opción de incorporación privada requiere que administres el elemento HTML <iframe> directamente para incorporar tu contenido de Looker y que el usuario acceda a Looker por separado de la aplicación alojada.
Analizaremos este ejemplo de código de incorporación privada:
<iframe
src="https://instance.looker.com/embed/dashboards/4?Timeframe=14+day"
width="600"
height="300"
frameborder="0">
</iframe>
1. Crea la URL del contenido incorporado
Considera un ejemplo de contenido de Looker en la URL https://instance.looker.com/dashboards/4?theme=red&Timeframe=14+day. A partir de esta URL de contenido de Looker, crearemos la URL de contenido incorporado y estableceremos el atributo src del iframe en ella. No dudes en usar tu propia URL de contenido de Looker mientras realizas estos pasos.
La URL del contenido incorporado de la muestra de código anterior es la siguiente:
La URL del contenido incorporado consta de tres partes:
- Nombre de host: Es el nombre de host de tu instancia de Looker.
- Ruta de URL: Es la ruta de URL del contenido de Looker con el prefijo
/embed(con pasos adicionales para las visualizaciones de consultas). - Parámetros: Son parámetros de URL que especifican filtros y temas.
El protocolo siempre debe ser https://. En este ejemplo, se compilará cada parte en detalle.
Parte 1: Nombre de host
- Navega a tu contenido de Looker. Siguiendo el ejemplo de la URL de contenido de Looker:
https://instance.looker.com/dashboards/4?theme=red&Timeframe=14+day. - El nombre de host de la URL de tu contenido incorporado es
instance.looker.com.
Parte 2: Ruta
La ruta de URL del contenido incorporado depende del contenido de Looker que incorpores.
Incorpora todo el contenido de Looker, excepto las visualizaciones de consultas
- Navega a tu contenido de Looker. A continuación, se muestra la URL de ejemplo del contenido de Looker:
https://instance.looker.com/dashboards/4?theme=red&Timeframe=14+day - Identifica la ruta de acceso de la URL de tu contenido de Looker:
/dashboards/4. - Agrega el prefijo
/embeda la ruta de la URL de tu contenido de Looker. La ruta de acceso de la URL de tu contenido incorporado es/embed/dashboards/4.
Incorpora una visualización de consulta
- Navega a la visualización de tu consulta. URL de ejemplo:
instance.looker.com/explore/my_model/my_explore?qid=1234567890abcdefghij12 - Identifica el ID de cliente de tu consulta. El parámetro
qid:1234567890abcdefghij12es el ID de cliente de tu consulta que representa la consulta y la configuración de las visualizaciones. - La ruta de URL del contenido incorporado es
/embed/query-visualization/, que se agrega con el ID de cliente de la consulta. La ruta de acceso de la URL del contenido incorporado de ejemplo es/embed/query-visualization/1234567890abcdefghij12
Parte 3: Parámetros
Los parámetros de URL del contenido incorporado controlan los filtros y el tema del contenido incorporado.
Filtros
- Navega a la URL de tu contenido de Looker.
- Ajusta manualmente los filtros del contenido según tus preferencias. En este ejemplo, la URL de contenido de Looker resultante es la siguiente:
https://instance.looker.com/dashboards/4?Timeframe=14+day - Los parámetros de URL de tu contenido incorporado son los parámetros de URL del contenido de Looker, por ejemplo,
Timeframe=14+day.
En este ejemplo, el parámetro Timeframe=14+day establece el valor del filtro Timeframe del panel.
Temas
Consulta la guía de temas para obtener información sobre cómo controlar la apariencia de tu contenido incorporado.
2. Prueba la URL de tu contenido incorporado
Abre la URL del contenido incorporado en tu navegador para obtener una vista previa de su comportamiento y apariencia.

3. Crea tu iframe
- Crea tu elemento iframe en la aplicación alojada.
- Establece el atributo
srcen la URL de tu contenido incorporado. - Define los atributos
width,heighty otros según lo que necesites para mostrar mejor tu contenido de Looker incorporado.
4. Considera los problemas de acceso de los usuarios
El usuario debe acceder a Looker para ver tu contenido incorporado. El iframe mostrará una página de error 401 si el usuario no accedió.
Opciones de acceso de los usuarios
Tu usuario puede acceder a Looker de una de las siguientes maneras:
1. Accede a Looker de antemano
El usuario debe acceder a Looker en el mismo navegador para poder ver el contenido incorporado.
2. Habilita una pantalla de acceso opcional de Looker incorporado
Agrega allow_login_screen=true a los parámetros de URL de contenido incorporado para presentar una pantalla de acceso de Looker en el iframe si el usuario no accedió. La URL de nuestro contenido de incorporación de ejemplo se convierte en lo siguiente: https://instance_name.looker.com/embed/dashboards/4?Timeframe=14+day&allow_login_screen=true
Ten en cuenta estas dos advertencias:
- Debes inhabilitar el parámetro de configuración Protecciones de mismo origen para las páginas de acceso de Looker para habilitar la pantalla de acceso de Looker en la incorporación de iframe.
- Si tu instancia de Looker autentica a los usuarios con el inicio de sesión único (SSO) con un proveedor de identidad, es posible que este bloquee la pantalla de acceso dentro del iframe. Si esto sucede, deberás usar la opción 1.
Política de cookies del navegador del usuario
Looker usa cookies para la autenticación de usuarios y el almacenamiento de sesiones. El navegador del usuario debe habilitar las cookies de terceros si el nombre de host de la URL del contenido incorporado de la instancia de Looker a la que accede el usuario se encuentra en un dominio diferente del de la aplicación alojada.
Algunos navegadores, como Firefox y Safari, tienen una política de cookies predeterminada que bloquea las cookies de terceros. Si el navegador del usuario no puede permitir cookies de terceros, puedes agregar un dominio personalizado a tu instancia de Looker para que la aplicación alojada y el nombre de host de la URL de contenido incorporado de la instancia de Looker residan en el mismo dominio.
5. Interactúa con tu iframe
Comienza a usar la mensajería posterior de iframe de incorporación de Looker.
Próximos pasos
Comienza con la incorporación firmada usando nuestro SDK de incorporación y consulta ejemplos de lo que puedes hacer con la incorporación de Looker.