Configuración del administrador: Incorporar

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 utilizar este parámetro de configuración para usar los eventos de JavaScript para 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 utiliza el iframe y, luego, selecciona Update.

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 a fin de indicar si quieres permitir o no la incorporación entre dominios:

  • Inhabilitada: Looker permite la incorporación de orígenes cruzados.
  • Habilitada: Looker no permite la incorporación de orígenes cruzados.

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 sea 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 que no sea de 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.

Establece Protecciones del mismo origen para las páginas de acceso de Looker como Habilitadas si se cumple alguna de las siguientes condiciones:

  • No incorporas ningún contenido de Looker.
  • Solo debes usar 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 tu selección.

Incorporar la autenticación de SSO

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

URL personalizada de alertas y programaciones

A menos que esté inhabilitada, las entregas de correo electrónico desde los paneles incorporados, ya sea desde 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 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 alertas y entregas de correos electrónicos programadas que vincularán a los usuarios incorporados a la aplicación incorporada, 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 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 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 alertas. Por ejemplo, app.customer.com.

  • URL definida por el usuario: 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 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 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 Content ID. 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 seleccionado en el campo Dominio en el 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.

La opción Seleccionar ruta del contenido no estará disponible si se deja en blanco el campo Incorporar dominio para la lista de entidades permitidas de programaciones y alertas.

Etiqueta de URL

Utiliza este campo para ingresar un nuevo texto predeterminado para el vínculo, que reemplazará al texto Ver 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 como Habilitada si quieres mostrar los 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 la navegación de vista

La función Navegación para quitar la vista les permite a los administradores personalizar aún más el contenido incorporado, específicamente las Exploraciones y los paneles incorporados.

Cómo quitar 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:

Si la estableces como Habilitada, la función Quitar la navegación de la vista quitará todas las referencias a las vistas, incluidas las opciones Guardar como vista y Guardar y programar, del menú de ajustes Explorar acciones de la exploración incorporada.

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.

Quita la navegación de vista de los paneles incorporados

Si la opción Quitar la navegación de la vista está habilitada, se quitarán las referencias y opciones de navegación a las vistas desde las exploraciones incorporadas y los mosaicos del panel vinculados a la vista incorporados.

Si la opción Quitar navegación de la vista está Inhabilitada, los usuarios de incorporación tendrán la opción de Ver vista en el menú de tres puntos Acciones de mosaico en los mosaicos vinculados a la vista.

Navegación de contenido incorporado en el panel

Cuando se habilita esta opción, los visualizadores del panel incorporado a los que se les otorgaron los permisos necesarios pueden ver las carpetas, las vistas y los paneles que contienen desde los paneles incorporados. Se requiere habilitar esta función para permitir que los usuarios de los paneles incorporados puedan copiar, mover y borrar paneles.

Incorporar administración de contenido

Cuando esta opción está habilitada, los visualizadores del panel incorporado 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 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 en el panel Administrador. En cambio, el dominio incorporado está asociado a la sesión sin cookies y existe solo durante la sesión. Consulta las prácticas recomendadas de seguridad si decides aprovechar esta función.

Secreto de JWT incorporado

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 esté habilitada la autenticación de SSO de incorporación, pero la incorporación sin cookies usa el Secreto de JWT de incorporación en lugar de Secreto de incorporación.

Esta opción te permite establecer o restablecer el secreto de JWT de la 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 incorporado nunca se expone, ya que solo lo usa el servidor de Looker de forma interna.

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

Secreto de incorporación

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 tu secreto, selecciona el botón Restablecer secreto. Sin embargo, debes tener en cuenta que esto romperá cualquier incorporación firmada existente.

Incorporar el 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 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 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 valores que se incluyen en la URL de incorporación firmada.