帆软云账号单点登录插件

1. 概述

1.1 版本

1.2 功能简介

企业同时启用 FineBI/FineReport（以下统称帆软应用） 和简道云/FineBI Cloud（以下统称一体化平台）时，用户每次切换系统都需重新输入账号密码，体验割裂、操作路径变长。

通过一体化平台的「集成应用」功能与帆软应用的「帆软云账号单点登录」插件，可将一体化平台作为统一身份入口：用户在一体化平台中单击集成应用或帆软应用链接，浏览器直接跳转并以当前一体化平台登录用户的成员编号作为帆软应用用户名完成免登，无需再次输入账号密码。

2. 前置准备

本节列出配置前必须满足的条件。任一条件不满足时，集成将无法生效或跳转报错，请逐项确认。

2.1 一体化平台端

1）检查操作用户权限：仅一体化平台企业创建者与系统管理员支持配置集成应用。

2）检查一体化平台版本：企业版及以上版本支持「集成应用」功能。

2.2 帆软应用端

1）确认帆软应用已开启 HTTPS 并配置可信域名。

2）关闭帆软应用的「点击劫持攻击防护」，允许帆软应用的模板/仪表盘页面被嵌入一体化平台中显示。操作如下：

以管理员身份登录帆软应用，单击「管理系统>安全管理>安全防护」，单击「Security Headers>高级设置」，关闭「点击劫持攻击防护」。

2.3 一体化平台与帆软应用之间

1）确认网络联通性：一体化平台与帆软应用必须网络互通。若帆软应用部署在纯内网环境中，须自行开放网络白名单，否则集成无法生效。

2）检查用户匹配情况：一体化平台成员编号必须与帆软应用用户名一一对应。

3. 操作步骤

先在帆软应用侧开启免登能力，再在一体化平台侧创建集成应用并取得凭证，帆软应用回填一体化平台配置后，启用一体化平台集成应用。

3.1 帆软应用安装帆软云账号单点登录插件

此步骤开启帆软应用对一体化平台单点免登的支持。

1）在帆软应用中进入「管理系统 > 插件管理」，安装「帆软云账号单点登录​」插件。安装插件方法请参见：插件安装

2）安装完毕后，单击「管理系统>系统管理」，确认可查看并配置「帆软云账号单点登录」。

3.2 一体化平台创建集成应用

此步骤用于获取服务端身份验证所需的 Suite ID 与 Suite Secret。

1）登录一体化平台，单击「管理后台>基本信息>产品中心」。

2）单击「+ 集成更多应用」，创建新的集成应用。

3）在弹出的「配置集成应用」对话框中填写配置信息，单击「创建」。各配置项填写说明如下：

4）在集成应用卡片上单击「编辑」，进入集成应用配置详情页。

5）复制自动生成的 Suite ID 与 Suite Secret，供 3.3 节回填使用。

3.3 帆软应用回填一体化平台配置

此步骤将一体化平台凭证与接口地址写入帆软应用，建立两端的信任关系。

1）以管理员身份登录帆软应用，单击「管理系统>系统管理>帆软云账号单点登录」。

2）按下表填写配置信息，单击「保存」生效。

3.4 一体化平台启用集成应用

此步骤正式开启集成能力，未开启开关时前述配置不生效。

1）在一体化平台「管理后台>产品中心」页面中找到「帆软应用」集成应用卡片。

2）将卡片右侧开关切换至开启状态。

4. 效果预览

完成 3. 操作步骤后，请按本章验证免登是否生效。

预期结果为：从一体化平台跳转帆软应用时不出现登录页，且帆软应用的登录用户与一体化平台当前用户编号一致。

4.1 校验前提

1）确认一体化平台与帆软应用中存在同名用户。

例如一体化平台中存在成员编号为「F000020」的系统管理员，帆软应用中存在用户名为「F000020」的用户。

2）确认该用户具备目标资源的查看权限。

例如一体化平台中嵌入了某张帆软应用模板/仪表板链接，若该用户无此模板查看权限，则免登可成功但模板无法正常展示。

4.2 系统管理员在管理后台免登访问帆软应用

1）以成员编号为「F000020」的系统管理员身份登录一体化平台，进入「管理后台>基本信息>产品中心」。

2）在帆软应用集成应用卡片中单击「进入应用」。

3）浏览器跳转至帆软应用，帆软应用以一体化平台当前登录用户编号「F000020」作为用户名免登进入，并停留在 3.2 节「应用首页」配置的地址，支持查看有权限的目录内容。

4.3 普通用户在FineBI Cloud中通过网页框查看帆软应用模板

1）制作FineBI Cloud仪表板

在FineBI Cloud仪表板中，添加「网页框」容器。

在网页框「属性>链接地址」中添加帆软应用的模板/仪表板访问链接，并确认帆软应用用户「F000020」有权访问该模板/仪表板。

2）查看FineBI Cloud仪表板

以成员编号为「F000020」的一体化平台用户身份，在FineBI Cloud中查看该仪表盘。

一体化平台自动单点登录帆软应用，实现免登录即可在FineBI Cloud中查看帆软应用模板。

4.4 普通用户在简道云中通过嵌入页面查看帆软应用模板

1）制作简道云仪表盘

在简道云仪表盘中，添加「嵌入页面」组件。

编辑组件的「页面链接」，添加帆软应用的模板/仪表板访问链接，并确保帆软应用用户「F000020」有权访问该模板/仪表板。

2）查看简道云仪表盘

以成员编号为「F000020」的一体化平台用户身份，在简道云工作台中查看该仪表盘。

一体化平台自动单点登录帆软应用，实现免登录即可在简道云中查看帆软应用模板。

4.5 普通用户在一体化平台中单击超链免登访问帆软应用

1）在一体化平台工作台快捷入口中添加帆软应用的模板/仪表板访问链接，并确认帆软应用用户「F000020」有权访问该模板/仪表板。

2）以成员编号为「F000020」的一体化平台用户身份，在工作台单击该链接。

3）浏览器跳转至帆软应用，以用户名「F000020」免登进入，并直接展示该模板/仪表板内容。

4.6 普通用户在帆软应用中查看FineBI Cloud仪表板

1）帆软应用目录挂载FineBI Cloud仪表板

在帆软应用目录或模板的网页框中，添加 FineBI Cloud 仪表板访问链接

并确保一体化平台成员「F000020」有权访问该仪表板，确保帆软应用用户「F000020」有权访问该目录。

2）用户查看FineBI Cloud仪表板

以用户名为「F000020」的帆软应用用户身份登录，查看该目录。

帆软应用自动单点登录一体化平台，实现免登录即可在帆软应用中查看FineBI Cloud仪表板。

5. 常见问题

问：从一体化平台跳转帆软应用时报错：当前登录的「简道云编号」无法与「FineBI已有用户名」匹配，如何处理？

答：最可能原因是两端用户未一一对应。

1）在一体化平台「管理后台>通讯录>内部组织」中查看当前用户的成员编号；

2）在帆软应用「管理系统>用户管理」中按该编号搜索用户名；

3）若不存在，则在帆软应用中新增同名用户或修正用户名后重新跳转。

问：免登成功但仪表板显示无权限或内容空白，如何处理？

答：免登只完成身份传递，不改变资源权限。

请在帆软应用「管理系统>权限管理」中为该用户授予目标仪表板的查看权限；若为嵌入场景且页面整体空白，请按 2.2 节确认「点击劫持攻击防护」已关闭。