Configuración del administrador: Incorporación

La página Integrar en la sección Plataforma del menú Administrador te permite configurar los parámetros de configuración para el contenido integrado de Looker.

Lista de entidades permitidas de dominios incorporados

Debes usar este parámetro de configuración para utilizar eventos de JavaScript y 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 origen cruzado:

  • Inhabilitado: Looker permite la incorporación de origen cruzado.
  • 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 principal no sea compatible con el nombre de dominio de la instancia de Looker. En estos casos, debes establecer la opción Protecciones de mismo origen para las páginas de acceso de Looker en Inhabilitado:

  • Si utilizas la incorporación privada de contenido de Looker en un iframe de una página web alojada en un dominio que no es de Looker, debes inhabilitar las 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.

Establece Protecciones de mismo origen para las páginas de acceso de Looker en 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 el parámetro de configuración de la protección del 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.

Incorpora la autenticación de SSO

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

URL personalizada de alertas y programaciones

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

La opción URL personalizada de alertas y programaciones te permite configurar una URL personalizada en las alertas y los envíos de correos electrónicos programados 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 de correos electrónicos. 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 el 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 el 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.

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

  • Incorpora 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 Looker al panel integrado, con el slug de contenido. Por ejemplo, app.customer.com/dashboards/CQ1fu99Z9Y1ggq2wcHDfMm.

Select content path no está disponible si el campo Embed domain for schedules and alerts allowlist se deja en blanco.

Etiqueta de URL

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

Mostrar filtros en las vistas incorporadas

Establece esta opción en Habilitado si deseas mostrar los valores de los filtros en los Looks incorporados.

Establece esta opción en Inhabilitado para ocultar los valores de los filtros en los Looks incorporados.

Selecciona Actualizar para guardar el parámetro de configuración.

Cómo quitar la navegación de vista

La función Quitar la navegación de Look permite a los administradores personalizar aún más el contenido integrado, específicamente los Explores integrados y los paneles integrados.

Se quitó la navegación de vista de los Explorar incorporados

De forma predeterminada, los usuarios integrados que tienen los permisos explore y save_content verán las siguientes opciones en el menú de ajustes Explorar acciones de un Explorar integrado:

Cuando se configura como Habilitado, la función Remove Look Navigation quita todas las referencias a Looks, incluidas las opciones Guardar como Look y Guardar y programar, del menú de ajustes Explore Actions de la función Explorar incorporada.

Deja la opción configurada como Inhabilitado para conservar las referencias a los Looks y las opciones Guardar como Look y Guardar y programar en los Explorar incorporados.

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

Cuando la opción Remove Look Navigation está Habilitada, se quitarán las referencias y las opciones de navegación a los Looks desde las Exploraciones incorporadas y los mosaicos de paneles incorporados vinculados a Looks.

Cuando la opción Remove Look Navigation está Inhabilitada, los usuarios de la incorporación tendrán la opción de Ver Look en el menú de tres puntos Acciones de la tarjeta en las tarjetas vinculadas a Looks.

Navegación de contenido integrado en el panel

Cuando esta opción está habilitada, los usuarios de paneles integrados que tengan los permisos necesarios pueden ver carpetas y las Vistas y los paneles que contienen desde los paneles integrados. Habilitar esta función es obligatorio para permitir que los usuarios que ven los paneles integrados copien, muevan y borren paneles.

Administración de contenido incorporado

Cuando esta opción está habilitada, los usuarios del panel integrado que tengan los permisos necesarios pueden copiar, mover y borrar paneles.

Incorporación sin cookies

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

Incorpora el 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 autenticación de SSO incorporada, pero usa el secreto de JWT incorporado en lugar del secreto incorporado.

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

Restablecer el token JWT invalidará todas las sesiones activas de incorporación sin cookies.

Incorporar secreto

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

Para recuperar el secreto de incorporación, selecciona el botón Set Secret.

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

Validador de URI de incorporación

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 de incorporación 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, en la sección Verificación rápida del URI de incorporación, se mostrarán los parámetros y los valores que se incluyen en la URL de incorporación firmada.