La página Incrustar, en la sección Plataforma del menú Administrador, te permite configurar la configuración del contenido de Looker incorporado.
Lista de entidades permitidas de dominios incorporados
Debes usar este parámetro de configuración para usar los 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 Protección de mismo origen para las páginas de acceso de Looker para indicar si quieres permitir o no la incorporación entre orígenes:
- Inhabilitado: Looker permite la incorporación de origen cruzado.
- Habilitado: Looker no permite la incorporación de varios orígenes.
En algunos casos de uso, debes permitir que las páginas de acceso de Looker aparezcan dentro de un iframe de Looker, incluso si la página superior no es compatible con el nombre de dominio de la instancia de Looker. En estos casos, debes tener la opción Protección de mismo origen para las páginas de acceso de Looker configurada como Inhabilitada:
- 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 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 Protección de mismo origen para las páginas de acceso de Looker en Habilitada si se cumple alguna de las siguientes condiciones:
- No incorporas ningún contenido de Looker.
- Solo debes usar incorporaciones firmadas, ya que la página de acceso de Looker no se usa para incorporaciones firmadas.
Para cambiar la 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.
Cómo incorporar la autenticación de SSO
La función Embed SSO Authentication debe estar habilitada si deseas usar la función Signed embedding de Looker. Para ello, selecciona Habilitada y, luego, Actualizar.
URL personalizada de alertas y programaciones
A menos que se inhabiliten, las publicaciones por correo electrónico de los paneles incorporados, ya sea de alertas o de publicaciones 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 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 las publicaciones de correo electrónico programadas 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 publicaciones por correo electrónico. Los dominios que se indican aquí se propagarán en el campo Dominio de 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á un dominio para que el usuario seleccione en el programa o el diálogo de alertas.
Selecciona la ruta de acceso al contenido
Este menú desplegable te permite seleccionar el formato de la URL del vínculo personalizado. Tiene las siguientes opciones:
Solo incorporar el dominio: La URL del vínculo personalizado solo incluye 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 que se seleccione 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.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 incorporado, con el slug de contenido. Por ejemplo,
app.customer.com/dashboards/CQ1fu99Z9Y1ggq2wcHDfMm.
La opción Seleccionar ruta de acceso al contenido no está disponible si el campo Incorporar dominios para la lista de entidades permitidas de programaciones y alertas está 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 los envíos de correo electrónico. 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 Habilitada si deseas mostrar valores de filtro en los aspectos visuales incorporados.
Establece esta opción en Inhabilitado para ocultar los valores de los filtros en los aspectos visuales incorporados.
Selecciona Actualizar para guardar la configuración.
Cómo quitar la navegación de vista
La función Quitar navegación de aspecto permite a los administradores personalizar aún más el contenido incorporado, específicamente las Exploraciones y los paneles incorporados.
Se quitó la navegación de vista de las Exploraciones incorporadas
De forma predeterminada, los usuarios incorporados que tengan los permisos explore y save_content verán las siguientes opciones en el menú de ajustes Explore Actions de una experiencia de Explore incorporada:
- La opción para guardar como un aspecto
- La opción Guardar y programar (para usuarios incorporados que tienen los permisos de envío o programación)
Cuando se establece en Habilitada, la función Quitar navegación de diseño quita todas las referencias a los diseños, incluidas las opciones Guardar como diseño y Guardar y programar, del menú de ajustes Explore Actions de la función Explorar incorporada.
Deja la opción configurada en Inhabilitado para mantener las referencias a las opciones Guardar como vista y Guardar y programar en las Exploraciones incorporadas.
Se quitó la navegación de vista de los paneles incorporados
Cuando la opción Quitar navegación de diseño esté Habilitada, se quitarán las referencias y las opciones de navegación a los diseños de exploraciones incorporadas y a las tarjetas de panel vinculadas a diseños incorporadas.
Cuando la opción Quitar navegación de diseño esté inhabilitada, los usuarios incorporados tendrán la opción de Ver diseño en el menú de tres puntos Acciones de tarjetas en las tarjetas vinculadas a diseños.
Navegación del contenido incorporado en el panel
Cuando esta opción está habilitada, los usuarios de los 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. Debes habilitar esta función para permitir que los usuarios de los paneles incorporados copien, muevan y borren paneles.
Administración de contenido incorporado
Cuando esta opción está habilitada, los usuarios 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 de incorporación cuando se adquiere la sesión sin cookies. Esta es una alternativa para agregar el dominio incorporado con el panel Administrador > Incorporar 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 Incorporar del panel Administrador. En cambio, el dominio incorporado está asociado con la sesión sin cookies y solo existe durante la sesión. Revisa las prácticas recomendadas de seguridad si decides aprovechar esta función.
Cómo incorporar el secreto de JWT
Se requiere un Secret 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 Incorporación de secreto de JWT en lugar de Incorporación de 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 de incorporación, el secreto de JWT de incorporación nunca se expone, ya que solo el servidor de Looker lo usa de forma interna.
Si restableces el token JWT, se invalidarán todas las sesiones de incorporación activas sin cookies.
Cómo incorporar un secreto
Se necesita un secreto de incorporación para usar la función de incorporación firmada de Looker.
Para recuperar el secreto incorporado, selecciona el botón Establecer secreto.
Para cambiar el secreto, selecciona el botón Restablecer secreto. Sin embargo, debes tener en cuenta que esto anulará cualquier incorporación firmada existente.
Validador de URI incorporado
Después de generar una URL para la función de inclusió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 URIs mostrará un mensaje que indicará 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 del URI de incorporación mostrará los parámetros y valores que se incluyen en la URL de incorporación firmada.