Saltar al contenido principal

Mosaico: inserción externa (`externalEmbed`)

CampoValor
Identificador del mosaicoexternalEmbed
Etiqueta del panelExternal embed / Einbettung
Categoríabasic
Tamañosembedded

El mosaico de inserción externa muestra una herramienta de reservas u otra página de terceros directamente en una aplicación web publicada. Las aplicaciones iOS y Android instaladas muestran el mismo iframe restringido dentro de su WebView de Capacitor.

Entrada aceptada​

El panel acepta una de las siguientes opciones:

  • Una URL HTTPS pública.
  • Código que contenga un iframe con un único atributo src entre comillas.

Solo se almacena la URL normalizada del iframe. Scoutello ignora el ancho, la altura, los estilos, los permisos, la configuración del sandbox, los controladores de eventos, los scripts y todo el código circundante proporcionado por el proveedor. Se rechazan las direcciones HTTP, las credenciales, los puertos personalizados, las direcciones IP, los hosts locales o internos, los hosts controlados por Scoutello y el código de iframe no válido. Scoutello no obtiene, resuelve, captura ni analiza de ningún otro modo la URL enviada.

El panel muestra una vista previa de la configuración local y no contacta deliberadamente con el proveedor. Comprueba el resultado real en la aplicación web publicada.

Carga, privacidad y permisos​

El iframe se carga automáticamente y de forma diferida cuando se acerca al área visible. Esto puede poner en contacto al visitante con el proveedor externo antes de que interactúe con el mosaico. No existe un flujo integrado para que el visitante haga clic y cargue el contenido ni para gestionar el consentimiento.

Antes de guardar, la organización debe confirmar que el proveedor es de confianza y que se han gestionado los avisos de privacidad o el consentimiento necesarios. Esta confirmación registra una decisión de configuración; no constituye el consentimiento del visitante.

Las alturas para móvil y escritorio pueden configurarse entre 240 y 1.600 píxeles. Los valores predeterminados son 640 píxeles en móvil y 720 píxeles en escritorio. Las capacidades de pago y pantalla completa del navegador son opcionales y están desactivadas de forma predeterminada. Nunca se conceden permisos para la cámara, el micrófono, la geolocalización, el portapapeles, las descargas ni la navegación de nivel superior.

El entorno de ejecución utiliza una configuración del sandbox y de la política de referencia controlada por el código. Los tokens de sandbox o permisos proporcionados por la clientela nunca llegan al iframe renderizado. Consulta la especificación de iframe de WHATWG para conocer la semántica del sandbox del navegador.

Limitaciones de inserción​

Los proveedores pueden prohibir la inserción mediante una directiva frame-ancestors de la Política de seguridad de contenido o mediante un encabezado X-Frame-Options. Como los navegadores no exponen información fiable sobre los errores de inserción entre orígenes, Scoutello no puede verificar la compatibilidad en el panel ni distinguir siempre entre el rechazo del proveedor y una página del proveedor vacía.

Si una configuración guardada deja de ser válida, la experiencia de la persona visitante muestra un estado de error localizado y, cuando es posible, una opción alternativa para abrir el contenido externamente.

Proveedores que requieren scripts​

Los scripts arbitrarios de proveedores no pueden ejecutarse en una página de Scoutello. Se bloquean los envíos que solo contienen un script y se ofrece la opción Solicitar integración del proveedor. La solicitud recopila el nombre del proveedor, la URL de su documentación pública, el caso de uso previsto y una muestra del script. Elimina los secretos, las credenciales privadas y los datos personales antes de enviarla.

La muestra del script se almacena únicamente como texto sin formato en la solicitud de soporte y nunca se renderiza ni se ejecuta. La aprobación no desbloquea ese fragmento. Da lugar a un trabajo de producto para crear un adaptador del proveedor revisado, alojado en un documento aislado en un origen sin cookies y registrable por separado, con una Política de seguridad de contenido específica del proveedor y mensajería cuya procedencia se verifica. Esto sigue las directrices de OWASP sobre JavaScript de terceros.

Lista de comprobación de soporte​

  • Confirma que la dirección es HTTPS público y pertenece al proveedor previsto.
  • Confirma que el proveedor permite la inserción mediante iframe en el origen publicado.
  • Activa el pago o la pantalla completa solo cuando la documentación del proveedor lo requiera.
  • Revisa los avisos de privacidad y el comportamiento del consentimiento antes de publicar.
  • Utiliza la solicitud de integración del proveedor para los widgets que solo funcionan con scripts; no pegues secretos.