Cómo comenzar con las incorporaciones privadas

Prueba de conocimiento: En esta página, se asume que ya conoce los conceptos básicos de los elementos HTML <iframe> del marco intercalado, las URL uniformes de recursos y las cookies de terceros. Consulta la documentación web de MDN sobre iframes para familiarizarte con los conceptos básicos.

En esta página, se te indicará 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 host.

Explicaremos este ejemplo de código de incorporación privado:

<iframe
    src="https://instance.looker.com/embed/dashboards/4?Timeframe=14+day"
    width="600"
    height="300"
    frameborder="0">
</iframe>

Nota: Las siguientes instrucciones se aplican a todo el contenido integrable de Looker: paneles, paneles de LookML, Explora, Looks, visualizaciones de consultas y extensiones.

1. Compila la URL del contenido incorporado

Consideremos un ejemplo de contenido de Looker en la URL https://instance.looker.com/dashboards/4?theme=red&Timeframe=14+day. Con esta URL de contenido de Looker, crearemos la URL de contenido incorporado y estableceremos el atributo src del iframe. No dudes en usar tu propia URL de contenido de Looker mientras realizas estos pasos.

La URL de contenido incorporado de la muestra de código anterior es la siguiente:

https://instance.looker.com/embed/dashboards/4?theme=red&Timeframe=14+día

La URL de contenido incorporado consta de tres partes:

• Nombre de host: el nombre de host de tu instancia de Looker
• Ruta de acceso: Ruta de URL de contenido de Looker con el prefijo /embed (con pasos adicionales para la visualización de consultas)
• Parámetros: Son parámetros de URL que especifican filtros y temas

El protocolo siempre debe ser https://. Vamos a crear cada parte en detalle.

Nota: A modo de atajo, considera que la URL de contenido incorporado es la URL completa de Looker con el prefijo embed/ a su ruta (a menos que incorpores visualizaciones de consulta como se indica a continuación).

Parte 1: Nombre de host

1. Navega a tu contenido de Looker. Sigue la URL de ejemplo de contenido de Looker: https://instance.looker.com/dashboards/4?theme=red&Timeframe=14+day.
2. El nombre de host de tu URL de contenido incorporado es instance.looker.com.

Nota: El nombre de host incluye el número de puerto, si está presente, p.ej., instance.looker.com:9999.

Parte 2: Ruta de acceso

La ruta de URL de tu contenido incorporado depende del contenido de Looker que incorpores.

Incorporar todo el contenido de Looker, excepto las visualizaciones de consultas

1. Navega a tu contenido de Looker. Sigue el ejemplo de la URL de contenido de Looker: https://instance.looker.com/dashboards/4?theme=red&Timeframe=14+day
2. Identifica la ruta de acceso de la URL del contenido de Looker: /dashboards/4.
3. Agrega el prefijo /embed a la ruta de acceso 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

1. Navega a la visualización de tu consulta. URL de ejemplo: instance.looker.com/explore/my_model/my_explore?qid=1234567890abcdefghij12
2. Identifica tu ID de cliente de la consulta. El parámetro qid: 1234567890abcdefghij12 es el ID de cliente de tu consulta que representa la configuración de la consulta y las visualizaciones.
3. La ruta de acceso de la URL del contenido incorporado está /embed/query-visualization/ con tu ID de cliente de consulta. La ruta de acceso del ejemplo de URL de contenido incorporado es /embed/query-visualization/1234567890abcdefghij12

Nota: También puedes encontrar el ID de cliente de la consulta con el método Get Query de la API de Looker como el campo client_id del objeto Query.

Parte 3: Parámetros

Los parámetros de URL de contenido incorporado controlan los filtros y los temas del contenido incorporado.

Filtros

1. Navega a la URL de tu contenido de Looker.
2. Ajusta manualmente los filtros del contenido según tus preferencias. Para este ejemplo, la URL del contenido de Looker resultante es: https://instance.looker.com/dashboards/4?Timeframe=14+day.
3. Los parámetros de URL de contenido incorporados son los parámetros de URL de contenido de Looker, p.ej., Timeframe=14+day

En este ejemplo, el parámetro Timeframe=14+day establece el valor del filtro Timeframe del panel.

Nota: El parámetro de filtro no crea el filtro; debe existir con anticipación en el panel.

Temas

Consulta la guía sobre temas para aprender a controlar la apariencia de tu contenido incorporado.

2. Prueba la URL del contenido incorporado

Abre la URL de contenido incorporado en tu navegador para obtener una vista previa del comportamiento y la apariencia del contenido incorporado.

3. Crea tu iframe

1. Crea el elemento de iframe en tu aplicación host.
2. Establece el atributo src en la URL del contenido incorporado.
3. Define los atributos width, height y otros para que puedas mostrar tu contenido de Looker incorporado de la mejor manera.

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 del usuario

Tu usuario puede acceder a Looker de una de las siguientes dos maneras:

1. Accede a Looker con anticipación

Tu usuario debe acceder a Looker en el mismo navegador para poder ver el contenido incorporado.

2. Habilitar una pantalla de acceso opcional de Looker incorporada

Agrega allow_login_screen=true a tus parámetros de URL de contenido incorporado para presentar una pantalla de acceso de Looker en el iframe si el usuario no accedió. Nuestro ejemplo de URL de contenido incorporado es: https://instance_name.looker.com/embed/dashboards/4?Timeframe=14+day&allow_login_screen=true.

Ten en cuenta dos advertencias:

• Debes inhabilitar la configuración de protecciones de mismo origen para páginas de acceso de Looker a fin de habilitar la pantalla de acceso de Looker en el iframe incorporado.
• Si tu instancia de Looker autentica a los usuarios mediante el inicio de sesión único (SSO) con un proveedor de identidad, este puede bloquear la pantalla de acceso en tu iframe. Si esto sucede, deberá 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 accede al nombre de host de la URL del contenido incorporado de la instancia de Looker, que se encuentra en un dominio diferente del de tu aplicación host.

Algunos navegadores, como Firefox y Safari, utilizan una política de cookies de forma predeterminada que bloquea las cookies de terceros. Si el navegador del usuario no permite el uso de cookies de terceros, puedes agregar un dominio personalizado a tu instancia de Looker para que la aplicación host y la instancia de URL de contenido incorporada incorpore el mismo dominio.

5. Interactúa con tu iframe

Comienza a usar los mensajes de iframe de incorporación de Looker.

Próximos pasos

Comience a usar la incorporación de SSO con nuestro SDK de incorporación y consulte los ejemplos de lo que puede hacer con la incorporación de Looker.