Incorporación privada

Además de la integración pública, también puedes incorporar looks, exploraciones y paneles de forma privada. Con la incorporación privada, puedes exigir que un usuario se autentique con un acceso de Looker, OAuth de Google o OpenID Connect. Si un usuario no se autentica, tienes la opción de mostrar un mensaje de error o mostrar una pantalla de acceso.

Los usuarios que accedan a contenido incorporado de forma privada estarán sujetos a la configuración del panel Administrador de Sesiones, que determina durante cuánto tiempo pueden permanecer en sus cuentas, si pueden acceder desde varios navegadores y si se cerrará la sesión después de un período de inactividad.

Si necesitas una solución incorporada más avanzada o personalizable, consulta nuestra página de documentación sobre Incorporación firmada.

Cómo generar una URL de incorporación

Para generar y copiar una URL de incorporación privada para un panel, una visualización de Explorar o un aspecto, selecciona Obtener URL de incorporación en el menú de tres puntos del panel o en el menú de ajustes de la acción Explorar en una Exploración o un Aspecto.

La pantalla Private Embed incluye los siguientes elementos:

  1. En el campo Content URL, se muestra la URL de incorporación privada completa.
  2. El campo Aplicar tema a la URL del panel te permite seleccionar un tema para agregarlo a la URL de incorporación si estás generando un panel o una URL de incorporación de Explorar, y tu instancia tiene habilitados los temas personalizados. El tema se aplicará cuando se vea el panel incorporado o Explorar.
  3. El interruptor Incluir parámetros actuales en la URL te permite elegir si deseas aplicar los parámetros actuales, como los valores de filtro, a la URL de incorporación. Si están habilitados, esos parámetros se aplicarán cuando se vea el contenido incorporado.
  4. Selecciona 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 de incorporación, puedes pegarla en una ventana o pestaña nueva del navegador para obtener una vista previa del contenido incorporado. También puedes usar esta URL para incrustar el contenido en un iframe.

Cómo obtener una vista previa del contenido incorporado

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

Visualización del contenido incorporado en un iframe

Coloca la URL de incorporación 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, se te mostrará cómo aparecerá el panel cuando se incorpore.

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 de incorporación para cambiar el tema que se usa para mostrar el panel.
  • Para cualquier tipo de panel, puedes usar el argumento de URL _theme para cambiar elementos individuales del tema del panel.
  • En el caso de un panel de LookML, también puedes modificar la apariencia incorporada de un panel a través del parámetro embed_style.

Si usas el argumento de URL theme, la opción Editar configuración de incorporación o el parámetro embed_style, se realizan cambios solo en el panel al que se aplica el argumento, la opción o el parámetro. Si deseas personalizar el aspecto de varios paneles incorporados, usa un tema.

Algunos parámetros de configuración de la pantalla anula otros. Para obtener más información, consulta la página de documentación Cómo crear y aplicar temas para paneles y exploraciones incorporados.

Habilita la pantalla de acceso para incorporaciones privadas

Puedes agregar el parámetro allow_login_screen=true a tu URL de incorporación si deseas 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.