跳转到主要内容

磁贴: 外部嵌入 (`externalEmbed`)

字段值
磁贴标识符externalEmbed
仪表板标签外部嵌入 / Einbettung
类别basic
尺寸embedded

外部嵌入磁贴会在已发布的 Web 应用中直接显示预订工具或其他第三方页面。已安装的 iOS 和 Android 应用会在其 Capacitor WebView 中渲染相同的受限 iframe。

接受的输入​

仪表板接受以下任一输入:

  • 公开的 HTTPS URL。
  • 包含一个 iframe 且带有一个加引号的 src 属性的标记。

系统只会存储规范化后的 iframe URL。Scoutello 会忽略提供商提交的宽度、高度、样式、权限、沙盒设置、事件处理程序、脚本及所有外围标记。系统会拒绝 HTTP 地址、凭据、自定义端口、IP 地址、本地或内部主机、由 Scoutello 控制的主机,以及格式错误的 iframe 代码。Scoutello 不会抓取、解析、截图或以其他方式探测所提交的 URL。

仪表板会显示本地配置预览,并会有意避免联系提供商。请在已发布的 Web 应用中测试实际结果。

加载、隐私与权限​

iframe 会自动以延迟方式加载,在接近可见区域时开始加载。这可能会在访客与磁贴交互之前联系第三方提供商。系统不提供内置的访客点击加载流程或同意管理器流程。

保存前,组织必须确认提供商可信,并确认已处理所需的隐私声明或同意管理。此确认记录的是内容创建决策,并不代表访客同意。

移动端和桌面端高度可设置为 240 至 1,600 像素。默认高度分别为移动端 640 像素和桌面端 720 像素。支付和全屏浏览器功能均为可选项,默认禁用。摄像头、麦克风、地理位置、剪贴板、下载和顶级导航功能永远不会被授予。

运行时使用由代码控制的沙盒和引用来源策略设置。客户提供的沙盒或权限令牌永远不会传递到渲染后的 iframe 中。有关浏览器沙盒语义,请参阅 WHATWG iframe 规范。

框架嵌入限制​

提供商可以通过内容安全策略 frame-ancestors 指令或 X-Frame-Options 标头禁止嵌入。由于浏览器不会公开可靠的跨源框架加载失败详情,Scoutello 无法在仪表板中验证兼容性,也无法始终区分提供商拒绝嵌入和提供商页面为空。

如果已保存的配置变得无效,访客体验会显示安全的本地化错误状态,并在可能的情况下提供打开外部页面的备用选项。

需要脚本的提供商​

任意提供商脚本都无法在 Scoutello 页面中运行。仅提交脚本会被阻止,并显示 请求提供商集成。请求会收集提供商名称、公开文档 URL、预期使用场景和脚本示例。提交前请删除机密信息、私有凭据和个人数据。

脚本示例只会作为纯文本支持请求内容存储,绝不会被渲染或执行。批准不会解锁该代码片段,而是为经审核的提供商适配器创建产品开发任务。该适配器托管在沙盒文档中,使用无 Cookie 且可单独注册的源,并配有提供商专属的内容安全策略和经过源验证的消息传递机制。此流程遵循 OWASP 第三方 JavaScript 指南。

支持检查清单​

  • 确认地址为公开 HTTPS 地址,并且属于目标提供商。
  • 确认提供商允许在已发布的源上嵌入 iframe。
  • 仅在提供商文档要求时启用支付或全屏功能。
  • 发布前检查隐私声明和同意行为。
  • 对于仅支持脚本的小组件,请使用提供商集成请求;切勿粘贴机密信息。