Incorporación privada

Además de la incorporación pública, también puedes incorporar las vistas, las exploraciones y los paneles de forma privada. Con la incorporación privada, puedes exigir que un usuario se autentique con un acceso de Looker, Google OAuth 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 acceden a sus cuentas y acceden a contenido incorporado de forma privada están sujetos a la configuración del panel de Administrador de Sesiones, que determina cuánto tiempo pueden permanecer en el acceso, si pueden hacerlo 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 nuestra página de documentación sobre Incorporaciones firmadas.

Cómo generar una URL de incorporación

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

La pantalla Incorporación privada 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 agregar a la URL de incorporación si generas un panel o una URL de incorporación 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 quieres aplicar los parámetros actuales, como los valores de filtro, a la URL incorporada. Si se habilitan, esos parámetros se aplicarán cuando se visualice el contenido incorporado.
  4. Selecciona el botón Copiar vínculo para copiar la URL de incorporación completa en el portapapeles.

Después de generar y copiar la URL de incorporación, 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 de incorporación en tu 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 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, inserta el iframe como desees.

Cambia 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, un panel incorporado se muestra 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:

  • Puedes especificar un nombre de tema diferente para cualquier tipo de panel 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 para cambiar elementos individuales del tema del panel.
  • Para un panel de LookML, también puedes modificar el aspecto incorporado de un panel a través del 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 hacen cambios en el panel al que se aplica el argumento, la opción o el parámetro. Si quieres personalizar el aspecto de varios paneles incorporados, usa un tema en su lugar.

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 exploraciones y paneles incorporados.

Habilitar 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 hayan accedido. 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.