La página Incorporar en la sección Plataforma del menú Administrador te permite establecer la configuración del contenido incorporado de Looker.
Lista de dominios permitidos incorporados
Debes utilizar este parámetro de configuración para aprovechar los eventos de JavaScript con el fin 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
Looker aplica una política de mismo origen para el contenido de iframe, lo que significa que una página no se puede mostrar en un iframe si el nombre de dominio de la página superior es diferente del nombre de dominio de la página de iframe. Esto brinda protección contra posibles ataques de compensación a la IU, comúnmente conocidos como captura de clic.
La única excepción a esta política es la página de acceso de Looker. En la página de acceso, puedes usar el parámetro de configuración Protecciones del mismo origen para las páginas de acceso de Looker a fin de indicar si deseas aplicar o no la política del mismo origen:
- Inhabilitada: Looker no aplica la política del mismo origen para la página de acceso.
- Habilitada: Looker aplica la política del mismo origen para la página de acceso.
Para 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 es compatible con el nombre de dominio de la instancia de Looker. En estos casos, debes tener la opción Protecciones del 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 de modo que Looker pueda mostrar la página de acceso en el iframe y permitir que los usuarios accedan a Looker.
Establece las Protecciones del mismo origen para las páginas de acceso de Looker como Habilitadas si se cumple alguna de las siguientes condiciones:
- No incorporaste 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 del mismo origen, usa el menú desplegable para seleccionar la opción deseada y, luego, asegúrate de seleccionar el botón Actualizar para guardar la selección.
Incorporar la autenticación de SSO
La función Embed SSO Authentication debe estar habilitada si quieres usar la función Incorporación firmada de Looker. Para ello, selecciona Enabled y, luego, Update.
URL personalizada de alertas y programaciones
A menos que la opción esté inhabilitada, las entregas de correo electrónico desde paneles incorporados, ya sea desde alertas o 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 más a fondo 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 las entregas programadas de correos electrónicos 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 vincular las URLs personalizadas en las entregas por correo electrónico. Los dominios que se incluyan 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 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:
Incorporar solo el dominio: La URL del vínculo personalizado solo incluye el dominio seleccionado en el campo Dominio del diálogo de programación o de alertas. Por ejemplo,
app.customer.com.URL definida por el usuario: La URL en el vínculo personalizado incluye el dominio 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 en el vínculo personalizado incluirá el dominio seleccionado en el campo Dominio, en el diálogo de programación o alertas, y la ruta de acceso de Looker al panel incorporado mediante 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 seleccionado en el campo Dominio, en el diálogo de programación o alertas, y la ruta de acceso de Looker al panel incorporado mediante el slug de contenido. Por ejemplo,
app.customer.com/dashboards/CQ1fu99Z9Y1ggq2wcHDfMm.
La opción Seleccionar la ruta del 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
Utiliza 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
Establece esta opción como Habilitada si quieres mostrar los valores de filtro en las vistas incorporadas.
Establece esta opción en Inhabilitada para ocultar los valores de filtro en las vistas incorporadas. Selecciona Actualizar para guardar la configuración.
Quitar navegación de vista
La función Quitar la navegación de vista les permite a los administradores personalizar aún más el contenido incorporado, específicamente las Exploraciones y los paneles incorporados.
Se quitará la navegación de vistas de las exploraciones incorporadas
De forma predeterminada, los usuarios incorporados con los permisos explore y save_content verán las siguientes opciones en el menú de ajustes Explorar acciones de una exploración incorporada, incluida la opción de Guardar como vista. Los usuarios incorporados que tengan los permisos de envío o programación también verán la opción Guardar y programar.
Si la estableces como Habilitada, la función Quitar la navegación de vista quitará todas las referencias a la vista, incluidas las opciones Guardar como vista y Guardar y programar, del menú de ajustes Explorar acciones incorporado en la exploración.
Deja la opción Inhabilitada para conservar las referencias a las vistas y las opciones Guardar como vista y Guardar y programar en las exploraciones incorporadas.
Se quitará la navegación de vista de los paneles incorporados
Además de quitar las referencias y la navegación a las vistas de las exploraciones incorporadas, la función Quitar la navegación de vistas también quitará las referencias de los mosaicos vinculados con la vista incorporados en los paneles cuando esa función esté Habilitada.
Si la opción Quitar la navegación de vista está Inhabilitada, los usuarios incorporados tendrán la opción de Ver vista desde los mosaicos vinculados con la vista.
Navegación de contenido incorporado en el panel
Cuando esta opción está habilitada, los lectores de los paneles incorporados a los que se les otorgaron los permisos necesarios pueden ver las carpetas, las vistas y los paneles que contienen desde los paneles incorporados. Debes 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 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, el dominio incorporado se puede incluir cuando se adquiere la sesión sin cookies. Esta es una alternativa a agregar el dominio de incorporación mediante 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 el panel Administrador > Incorporar. En cambio, el dominio incorporado está asociado 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 Secret JWT
Este parámetro de configuración aparece cuando la opción Incorporar la autenticación de SSO está habilitada y la opción Incorporación sin cookies está habilitada.
Se requiere un secreto de token web JSON (JWT) para utilizar 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 utiliza el Secreto JWT de incorporación en lugar de Secreto incorporado.
Esta opción te permite definir o restablecer el secreto JWT de incorporación. No es necesario configurar el secreto 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 de forma interna el servidor de Looker.
Si restableces el token JWT, se invalidarán todas las sesiones de incorporación activas sin cookies.
Incorporar Secret
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 Configurar secreto.
Es importante que copies el secreto y lo guardes en un lugar seguro de inmediato, ya que no puedes recuperar el secreto de esta página después de dejarlo.
Para cambiar tu secreto, selecciona el botón Restablecer secreto. Sin embargo, debes tener en cuenta que esto romperá cualquier incorporación firmada existente.
Incorporador de validador de URI
Esta configuración solo se revela si se estableció Embed Secret (Secreto de incorporación).
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 Incorporador de validador de URI y haciendo clic en Probar URI. El validador de URI devolverá 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, en la sección Comprobación rápida de URI de incorporación se mostrarán los parámetros y valores incluidos en la URL de incorporación firmada.
