本文将指导您如何通过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
效果展示
隐藏侧边菜单栏。
在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
效果展示
同时隐藏侧边菜单栏和页面导航栏。
在URL中添加
leftHidden=true
和topHidden=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
效果展示