Configuración del administrador: Incorporación

La página Embed de la sección Platform del menú Admin te permite configurar los parámetros de configuración del contenido incorporado de Looker.

Lista de entidades permitidas de dominios incorporados

Debes usar este parámetro de configuración para aprovechar los eventos de JavaScript para pasar datos o acciones entre una página superior y un iframe de Looker.

En ese caso, agrega el dominio en el que se usa el iframe a este campo y, luego, selecciona Actualizar.

Protecciones de mismo origen para las páginas de acceso de Looker

En el caso de la página de acceso de Looker, puedes usar el parámetro de configuración Protecciones de mismo origen para las páginas de acceso de Looker para indicar si deseas permitir la incorporación de varios orígenes:

  • Inhabilitado: Looker permite la incorporación de varios orígenes.
  • Habilitado: Looker no permite la incorporación de varios orígenes.

En ciertos casos de uso, debes permitir que las páginas de acceso de Looker aparezcan dentro de un iframe de Looker, incluso cuando la página superior no sea compatible con el nombre de dominio de la instancia de Looker. En estos casos, debes tener la opción Protecciones de mismo origen para las páginas de acceso de Looker configurada como Inhabilitado:

  • Si usas la incorporación privada de contenido de Looker en un iframe de una página web alojada por un dominio que no es de Looker, debes inhabilitar la opción Protecciones de mismo origen para las páginas de acceso de Looker para que Looker pueda mostrar la página de acceso en el iframe y permitir que los usuarios accedan a Looker.

Configura Protecciones de mismo origen para las páginas de acceso de Looker como Habilitado si se cumple alguna de las siguientes condiciones:

  • No incorporas ningún contenido de Looker.
  • Solo usas la incorporación firmada, ya que la página de acceso de Looker no se usa para las incorporaciones firmadas.

Para cambiar la configuración de la protección de mismo origen, usa el menú desplegable para seleccionar la opción que desees y, luego, asegúrate de seleccionar el botón Actualizar para guardar tu selección.

Incorporar autenticación de SSO

La función Incorporar autenticación de SSO debe estar habilitada si deseas usar la función Incorporación firmada de Looker. Para ello, selecciona Habilitado y, luego, Actualizar.

URL personalizada de alertas y programaciones

A menos que se inhabiliten, las entregas por correo electrónico de los paneles incorporados, ya sea de alertas o entregas programadas, incluyen un vínculo que dice Ver panel completo. Este vínculo permite que los destinatarios del correo electrónico se conecten a su instancia de Looker y exploren más los datos entregados en el correo electrónico.

La opción URL personalizada de alertas y programaciones te permite configurar una URL personalizada en las alertas y las entregas programadas por correo electrónico que vincularán a los usuarios incorporados a la aplicación de incorporación, en lugar de a una instancia de Looker.

Incorporar dominios para la lista de entidades permitidas de programaciones y alertas

Especifica todos los dominios a los que pueden vincularse las URLs personalizadas en las entregas por correo electrónico. Los dominios que se indican aquí propagarán el campo Dominio en los diálogos de programación y alertas.

Si este campo se deja en blanco, los vínculos personalizados no estarán disponibles, ya que no habrá ningún dominio para que un usuario seleccione en el diálogo de programación o alertas.

Selecciona la ruta de acceso al contenido

Este menú desplegable te permite seleccionar el formato de la URL en el vínculo personalizado. Tiene las siguientes opciones:

  • Solo incorporar dominio : La URL del vínculo personalizado incluye solo el dominio seleccionado en el campo Dominio del diálogo de programación o alertas. Por ejemplo, app.customer.com.

  • URL definida por el usuario : La URL del vínculo personalizado incluye el dominio que se selecciona en el campo Dominio del diálogo de programación o alertas y la ruta de acceso que ingresa el usuario en el campo Ruta de acceso del diálogo de programación o alertas. Por ejemplo, app.customer.com/my_embed_app.

  • Incorporar la URL del dominio con los IDs de Looker : La URL del vínculo personalizado incluirá el dominio que se selecciona en el campo Dominio del diálogo de programación o alertas y la ruta de acceso de Looker al panel incorporado, con el ID de contenido. Por ejemplo, app.customer.com/dashboards/12.

  • Incorporar la URL del dominio con los slugs de Looker : La URL del vínculo personalizado incluye el dominio que se selecciona en el campo Dominio del diálogo de programación o alertas y la ruta de acceso de Looker al panel incorporado, con el slug de contenido. Por ejemplo, app.customer.com/dashboards/CQ1fu99Z9Y1ggq2wcHDfMm.

Selecciona la ruta de acceso al contenido no está disponible si el campo Incorporar dominios para la lista de entidades permitidas de programaciones y alertas se deja en blanco.

Etiqueta de URL

Usa este campo para ingresar un nuevo texto de vínculo predeterminado, que reemplazará el texto Ver panel completo en las entregas por correo electrónico. El texto predeterminado se puede cambiar en los diálogos de programación y alertas.

Mostrar filtros en las vistas incorporadas

Configura esta opción como Habilitado si deseas mostrar los valores de los filtros en las vistas incorporadas.

Configura esta opción como Inhabilitado para ocultar los valores de los filtros en las vistas incorporadas.

Selecciona Actualizar para guardar la configuración.

Quitar la navegación de vista

La función Quitar la navegación de vista permite que los administradores personalicen aún más el contenido incorporado, específicamente las exploraciones incorporadas y los paneles incorporados.

Cómo quitar la navegación de vista de las exploraciones incorporadas

De forma predeterminada, los usuarios incorporados que tienen los permisos explore y save_content verán las siguientes opciones en el Acciones de exploración menú de engranaje de una exploración incorporada:

Cuando se configura como Habilitado, la función Quitar la navegación de vista quita todas las referencias a las vistas, incluidas las opciones Guardar como vista y Guardar y programar, del menú de engranaje Acciones de exploración de la exploración incorporada.

Deja la opción configurada como Inhabilitado para conservar las referencias a las vistas y las opciones Guardar como vista y Guardar y programar en las exploraciones incorporadas.

Cómo quitar la navegación de vista de los paneles incorporados

Cuando Quitar la navegación de vista está Habilitado, se quitarán las referencias y las opciones de navegación a las vistas de las exploraciones incorporadas y los mosaicos de paneles vinculados a vistas incorporados.

Cuando Quitar la navegación de vista está Inhabilitado, los usuarios incorporados tendrán la opción de Ver vista en el menú de tres puntos Acciones del mosaico en los mosaicos vinculados a vistas.

Navegación por el contenido incorporado del panel

Cuando esta opción está habilitada, los lectores de paneles incorporados a los que se les otorgaron los permisos necesarios pueden ver las carpetas y las vistas y los paneles que contienen desde los paneles incorporados. Es necesario habilitar esta función para permitir que los lectores de paneles incorporados copien, muevan y borren paneles.

Administración de contenido incorporado

Cuando esta opción está habilitada, los lectores de paneles incorporados a los que se les otorgaron los permisos necesarios pueden copiar, mover y borrar paneles.

Incorporación sin cookies

A partir de Looker 23.8, se puede incluir el dominio incorporado cuando se adquiere la sesión sin cookies. Esta es una alternativa a agregar el dominio incorporado con el panel Admin > Embed de Looker. Looker guarda el dominio incorporado en la base de datos interna de Looker, por lo que no se mostrará en la página Embed del panel Admin. En cambio, el dominio incorporado se asocia con la sesión sin cookies y existe solo durante la sesión. Revisa las prácticas recomendadas de seguridad si decides aprovechar esta función.

Incorporar secreto de JWT

Se requiere un secreto de token web JSON (JWT) para usar la función de incorporación sin cookies. La incorporación sin cookies requiere que se habilite la Incorporación de autenticación de SSO, pero la incorporación sin cookies usa Incorporar secreto de JWT en lugar de Incorporar secreto.

Esta opción te permite establecer o restablecer el secreto de JWT incorporado. No es necesario configurar el secreto de JWT, ya que el primer intento de crear una sesión de incorporación sin cookies creará el token JWT. A diferencia del secreto incorporado, el secreto de JWT incorporado nunca se expone, ya que solo lo usa internamente el servidor de Looker.

Si restableces el token JWT, se invalidarán todas las sesiones de incorporación sin cookies activas.

Incorporar secreto

Se necesita un secreto incorporado para usar la función de incorporación firmada de Looker.

Para recuperar el secreto incorporado, selecciona el botón Establecer secreto.

Para cambiar tu secreto, selecciona el botón Restablecer secreto, pero debes tener en cuenta que esto interrumpirá cualquier incorporación firmada existente.

Validador de URI incorporado

Después de generar una URL para la función de incorporación firmada de Looker, puedes probarla pegándola en el campo Validador de URI incorporado y haciendo clic en Probar URI. El validador de URI mostrará un mensaje que indica si la URL de incorporación firmada es válida.

Después de ingresar una URL de incorporación firmada, la sección Verificación rápida de URI incorporado mostrará los parámetros y valores que se incluyen en la URL de incorporación firmada.