La página Incorporar en la sección Plataforma del menú Administrador te permite definir la configuración del contenido incorporado de Looker.
Lista de dominios incorporados permitidos
Debes usar este parámetro de configuración para aprovechar los eventos de JavaScript con el objetivo de pasar datos o acciones entre una página superior y un iframe de Looker.
En ese caso, agrega a este campo el dominio en el que se usa el iframe y, luego, selecciona Actualizar.
Protecciones de mismo origen para las páginas de acceso de Looker
En la página de acceso de Looker, puedes usar el parámetro de configuración Protecciones del mismo origen para las páginas de acceso de Looker para indicar si quieres permitir o no la incorporación de origen cruzado:
- Inhabilitado: Looker permite la incorporación de origen cruzado.
- Habilitada: Looker no permite la incorporación de origen cruzado.
Para ciertos casos de uso, debes permitir que las páginas de acceso de Looker aparezcan en 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 Inhabilitada:
- Si usas la incorporación privada del contenido de Looker en un iframe de una página web alojada por un dominio ajeno a Looker, debes inhabilitar las protecciones del 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 Habilitada si se cumple alguna de las siguientes condiciones:
- No incorporarás contenido de Looker.
- Solo usas incorporaciones firmadas, 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 del mismo origen, use el menú desplegable para seleccionar la opción deseada y, luego, asegúrese de seleccionar el botón Actualizar para guardar su selección.
Incorporar la autenticación de SSO
La función Incorporar autenticación de SSO debe estar habilitada si quieres usar la función de Incorporación firmada de Looker. Para hacerlo, selecciona Habilitada y, luego, Actualizar.
URL personalizada de alertas y programaciones
A menos que estén inhabilitadas, los envíos de correos electrónicos desde paneles incorporados, ya sea de 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 más detalle los datos entregados en el correo electrónico.
La opción Alertas y programación de URL personalizada te permite configurar una URL personalizada en las alertas y entregas programadas de correo electrónico que vincularán a los usuarios incorporados con la aplicación de incorporación, en lugar de hacerlo con 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 los envíos de correo electrónico. Los dominios que se enumeran 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 que el usuario pueda seleccionar 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 en el 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 está seleccionado en el campo Dominio en el diálogo de programación o alertas, y la ruta que ingresa el usuario en el campo Ruta 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 está seleccionado en el campo Dominio en el 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.Incorporar URL de dominio con slugs de Looker: La URL del vínculo personalizado incluye el dominio que está seleccionado en el campo Dominio en el 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 la ruta de acceso al contenido no está disponible si el campo Incorporar dominio para la lista de entidades permitidas de programas 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 los envíos 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
Establece esta opción como Habilitada si quieres mostrar valores de filtro en las vistas incorporadas.
Establece esta opción como Inhabilitada para ocultar los valores de filtro en las vistas incorporadas.
Selecciona Actualizar para guardar el parámetro de configuración.
Quitar 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 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 Explorar acciones de una exploración incorporada:
- La opción Guardar como vista
- La opción Guardar y programar (para incorporar usuarios que tengan los permisos de envío o programación)
Cuando se configura como Habilitada, la función Quitar navegación de vista quita todas las referencias a las vistas, incluidas las opciones Guardar como vista y Guardar y programar, del menú de ajustes Explorar acciones incorporado de Explorar.
Deja la opción Inhabilitada para mantener las referencias a las vistas y las opciones Guardar como vista y Guardar y programar en las exploraciones incorporadas.
Quitar la navegación de vista de los paneles incorporados
Cuando la opción Quitar navegación de vista esté habilitada, se quitarán las referencias y las opciones de navegación a las vistas desde las exploraciones incorporadas y los mosaicos del panel vinculados a la vista incorporados.
Cuando la opción Quitar navegación de vista esté inhabilitada, los usuarios incorporados tendrán la opción de Ver vista en el menú de tres puntos Acciones de mosaicos en los mosaicos vinculados a la vista.
Navegación de contenido incorporado en el panel
Cuando esta opción está habilitada, los visualizadores de paneles incorporados a los que se les otorgaron los permisos necesarios pueden ver las carpetas y las Vistas y los paneles que contienen de los paneles incorporados. Se requiere habilitar esta función para que los usuarios de los paneles incorporados puedan copiar, mover y borrar paneles.
Incorporación de administración de contenido
Cuando se habilita esta opción, los visualizadores 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, el dominio incorporado se puede incluir cuando se adquiere la sesión sin cookies. Esta es una alternativa a 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 se asocia con la sesión sin cookies y existe solo durante la sesión. Si decides aprovechar esta función, revisa las prácticas recomendadas de seguridad.
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 la Autenticación de SSO de incorporación esté habilitada, pero la incorporación sin cookies usa Incorporar secreto de JWT en lugar de Incorporar secreto.
Esta opción te permite definir o restablecer el secreto de JWT insertado. 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 de JWT. A diferencia del secreto de incorporación, el secreto de JWT de incorporación nunca se expone, ya que solo se usa internamente en el servidor de Looker.
Si restableces el token JWT, se invalidarán 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 Reset Secret (Restablecer secreto); sin embargo, debes tener en cuenta que esto romperá cualquier incorporación firmada existente.
Incorporar validador de URI
Después de generar una URL para la función de incorporación firmada de Looker, puedes probar la URL pegándola en el campo Embed URI Validator y haciendo clic en Probar URI. El validador de URI mostrará un mensaje que indicará si la URL de incorporación firmada es válida.
Después de que ingreses una URL de incorporación firmada, la sección Verificación rápida de URI de incorporación mostrará los parámetros y valores que se incluyen en la URL de incorporación firmada.