Incorporación privada

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

Los usuarios que acceden a su cuenta y a contenido incorporado de forma privada están sujetos a la configuración del panel Administrador de sesiones, que determina cuánto tiempo pueden permanecer conectados, si pueden acceder desde varios navegadores y si saldrán de la cuenta después de un período de inactividad.

Si necesitas una solución incorporada más avanzada o personalizable, consulta la página de documentación sobre incorporaciones firmadas.

Cómo generar una URL incorporada

Si deseas generar y copiar una URL de incorporación privada para un panel, una vista o una visualización de Explorar, selecciona Obtener URL incorporada en el menú de tres puntos del panel o en el menú de ajustes de acciones de Explorar en Explorar o Vista.

La pantalla Incorporación privada incluye los siguientes elementos:

  1. El campo Content URL muestra la URL de incorporación privada completa.
  2. El campo Aplicar tema a la URL del panel te permite seleccionar un tema para agregar a la URL incorporada si generas un panel o una URL incorporada de Explorar y si tu instancia tiene habilitados los temas personalizados. El tema se aplicará cuando se visualice el panel incorporado o la función 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 incorporada. Si se habilita, 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 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.

Cómo obtener una vista previa del contenido incorporado

Pega la URL incorporada en tu navegador para obtener una vista previa del comportamiento y aspecto 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.

Cambia la apariencia incorporada de un panel

Ver un panel con /embed en la URL te muestra cómo se verá el panel cuando esté incorporado.

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

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

Con el argumento de URL theme, la opción Editar configuración de incorporación o el parámetro embed_style, solo se pueden realizar cambios 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 pantalla anulan otros. Para obtener más información, consulta la página de documentación Crea y aplica temas para paneles incorporados y exploraciones.

Habilitar la pantalla de acceso para las incorporaciones privadas

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