使用iframe嵌入第三方系统

本文将指导您如何通过iframe将Dataphin嵌入第三方系统。

前提条件

第三方系统与Dataphin已完成SSO互通。更多信息,请参见Dataphin基于客户第三方SSO登录认证

使用限制

  • 因浏览器的安全策略,在非可信证书下会阻止iframe页面加载,Dataphin应用域名使用HTTPS协议且为非可信证书时,需要保证第三方系统和Dataphin同源,即协议、端口、域名均需要完全一致。例如,以阿里云的域名https://www.aliyun.com为例,即第三方系统主域名为https://www.aliyun.com,则Dataphin需要部署到相同的域名下,并通过https://www.aliyun.com/${dataphin}进行访问。

    说明
    • Dataphin应用域名使用HTTPS协议且为可信证书或使用HTTP协议时,支持iframe嵌入。

    • 自签名证书属于非可信证书。

  • 主应用和嵌入应用通信功能暂不支持。

  • 仅支持标签标准功能模块隐藏页面顶部菜单栏与左侧导航栏功能。

iframe嵌入

第三方系统与Dataphin已完成SSO互通后,在第三方系统中使用iframe标签引入Dataphin URL后即可正常嵌入。例如,以阿里云的域名www.aliyun.com为例,则嵌入代码为<iframe src="https://www.aliyun.com/dev/portal?tenantId=xxx&projectId=xxx&env=DEV"></iframe>

说明

tenantId参数部分需要替换为租户ID,projectId需要替换为项目ID。

隐藏页面导航与菜单栏

使用iframe将Dataphin嵌入第三方系统时,支持通过URL参数方式隐藏页面导航与菜单栏。

重要
  • 目前仅支持标签标准功能模块。

  • 隐藏页面导航栏(topHidden)和隐藏侧边菜单栏(leftHidden)支持组合使用。例如,ttps://www.aliyun.com/dev/portal?tenantId=xxx&projectId=xxx&env=DEV&topHidden=true&leftHidden=true

  • 隐藏页面导航栏。

    在URL中添加topHidden=true参数。

    描述/对比

    增加参数前

    增加参数后

    URL

    https://www.aliyun.com/dev/portal?tenantId=xxx&projectId=xxx&env=DEV

    https://www.aliyun.com/dev/portal?tenantId=xxx&projectId=xxx&env=DEV&topHidden=true

    效果展示

    image.png

    image.png

  • 隐藏侧边菜单栏。

    在URL中添加leftHidden=true参数。

    描述/对比

    增加参数前

    增加参数后

    URL

    https://www.aliyun.com/dev/portal?tenantId=xxx&projectId=xxx&env=DEV

    https://www.aliyun.com/dev/portal?tenantId=xxx&projectId=xxx&env=DEV&leftHidden=true

    效果展示

    image.png

    image.png

  • 同时隐藏侧边菜单栏和页面导航栏。

    在URL中添加leftHidden=truetopHidden=true参数。

    描述/对比

    增加参数前

    增加参数后

    URL

    https://www.aliyun.com/dev/portal?tenantId=xxx&projectId=xxx&env=DEV

    ttps://www.aliyun.com/dev/portal?tenantId=xxx&projectId=xxx&env=DEV&topHidden=true&leftHidden=true

    效果展示

    image.png

    image