Incorporación privada

Además de la incorporación pública, también puedes incorporar aspecto, exploraciones y paneles de forma privada para requerir autenticación con un acceso de Looker, Google OAuth o OpenID Connect. Si un usuario no está autenticado, tiene la opción de mostrar un mensaje de error o mostrar una pantalla de acceso.

Los usuarios que accedan a su cuenta y accedan a contenido incorporado de forma privada están sujetos a la configuración del panel Sesiones de administrador, que determina durante cuánto tiempo pueden permanecer conectados, si pueden hacerlo desde varios navegadores y si salen de sus cuentas después de un período de inactividad.

Si necesitas una solución incorporada más personalizable o avanzada, consulta nuestra página de documentación de incorporación del inicio de sesión único (SSO).

Cómo generar una URL incorporada

Para generar y copiar una URL de incorporación privada en un panel, una apariencia o una visualización de Explorar, selecciona Obtener URL de incorporación en un menú de tres puntos del panel o en el menú de acciones de Explorar en Explorar o Mirar. Looker mostrará la ventana Get URL in.

La ventana Obtener URL de incorporación incluye los siguientes elementos:

  1. En el campo URL de incorporación, se muestra la URL de incorporación privada completa.
  2. El campo Aplicar tema a la URL del panel te permite seleccionar un tema que se agregará a la URL de incorporación si generas un panel o una URL de incorporación de Explorar y tu instancia tiene habilitados los temas personalizados. El tema se aplicará cuando se visualice el panel incorporado o Explorar.
  3. El interruptor Incluir parámetros actuales en la URL le permite elegir si desea aplicar parámetros actuales, como valores de filtro, a la URL incorporada. Si se habilitan, esos parámetros se aplicarán cuando se visualice el contenido incorporado.
  4. Haz clic en el botón Copiar vínculo para copiar la URL de incorporación completa en el portapapeles.

Una vez que hayas generado y copiado la URL incorporada, puedes pegarla en una nueva ventana o pestaña del navegador para obtener una vista previa del contenido incorporado. También puedes usar esta URL para incorporar el contenido en un iframe.

Vista previa del contenido incorporado

Pega la URL de incorporación en el navegador para obtener una vista previa del comportamiento y la apariencia del contenido incorporado.

Cómo ver el contenido incorporado en un iframe

Coloca la URL incorporada en un iframe. Por ejemplo:

  <iframe
      src="https://instance_name.cloud.looker.com/embed/dashboards/1"
      width="1000"
      height="2000"
      frameborder="0">
  </iframe>

Luego, incorpora el iframe como desees.

Cómo cambiar la apariencia incorporada de un panel

Si ves un panel con /embed en la URL, podrás ver cómo aparecerá cuando esté incorporado.

De forma predeterminada, se muestra un panel incorporado con el tema predeterminado de tu instancia de Looker. Puedes cambiar la apariencia de tu panel incorporado de varias maneras, según el tipo de panel que uses:

  • Para cualquier tipo de panel, puedes especificar un nombre de tema diferente en la URL incorporada a fin de cambiar el tema que se usa para mostrar el panel.
  • Para cualquier tipo de panel, puedes usar el argumento de URL _theme a fin de cambiar los elementos individuales del tema del panel.
  • En un panel de LookML, también puedes modificar el aspecto incorporado de un panel mediante el parámetro embed_style.

Si usas el argumento de URL theme, la opción Edit Embed Settings o el parámetro embed_style solo se aplican los cambios al panel, se aplican el argumento, la opción o el parámetro. Si deseas personalizar la apariencia de varios paneles incorporados, usa un tema en su lugar.

Algunas opciones de configuración de visualización anulan otras. Para obtener más información, consulta la página de documentación Cómo crear y aplicar temas para los paneles incorporados y las exploraciones.

Habilitar la pantalla de acceso para las incorporaciones privadas

Puedes agregar el parámetro allow_login_screen=true a tu URL incorporada si quieres mostrar una pantalla de acceso a los usuarios que aún no accedieron. Por ejemplo:

<iframe src="https://instance_name.cloud.looker.com/embed/looks/4?allow_login_screen=true"></iframe>
                                                            ^^^^^^^^^^^^^^^^^^^^^^^

Si no agregas este parámetro, se mostrará un error 401 a los usuarios que aún no hayan accedido.