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 pedirle a un usuario que se autentique con un acceso de Looker, OpenID Connect o Google OAuth. Si un usuario no está autenticado, tienes la opción de mostrar un mensaje de error o 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 tras 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 Explorar en Explorar o Vista.

La pantalla Incorporación privada incluye los siguientes elementos:

  1. El campo URL de contenido 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 visualice la función Explorar o el panel incorporado.
  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.

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 de inserción.

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

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

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.

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 quieres personalizar el aspecto de varios paneles incorporados, usa un tema en su lugar.

Algunos parámetros de configuración de pantalla anulan 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 quieres mostrar una pantalla de acceso a los usuarios que aún no han 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.