集成应用功能介绍

1. 概述

集成应用使简道云作为身份提供方（IdP），向第三方系统颁发身份凭证，实现用户在简道云中一键免登进入外部系统，无需在第三方系统再次输入账号密码。

企业部署了多套系统（如 FineBI、FineReport、OA 等），用户每次切换系统都需要重新登录，体验割裂、效率低下。通过集成应用，简道云成为统一身份入口，用户在产品中心直接单击「进入应用」即可跳转并自动登录第三方系统。

适用场景：

将 FineBI、FineReport 等帆软产品接入简道云，实现报表和看板的免登查看
将企业自建 OA、HR、CRM 等系统接入简道云，实现业务系统的统一入口访问
在简道云仪表盘或表单中嵌入外部系统页面，实现页面级免登访问

2. 前提条件

开始配置集成应用前，请确认以下条件已满足。

2.1 简道云端

操作权限：仅企业创建者与系统管理员支持配置集成应用
版本要求：企业版及以上版本简道云支持集成应用功能。版本升级可点击：商务咨询。版本从可用降级为不可用时，已有配置保留，但无法使用集成应用功能。

2.2 第三方系统端

第三方系统已配置 HTTPS
第三方系统已配置可信域名
第三方系统支持通过 URL 参数或 OAuth 协议接收用户身份信息
若第三方系统为FineReport、FineBI，必须已关闭「点击劫持防护」等安全限制

3. 功能入口

集成应用提供两个入口，分别用于不同的使用场景。

3.1 从产品中心进入

用于创建和管理集成应用。

在「管理后台 > 基本信息 > 产品中心」页面，可查看已创建的集成应用。单击「+ 集成更多应用」可创建新的集成应用。

3.2 从单点登录设置进入

用于快速了解集成应用与单点登录的关系。

在「管理后台 > 企业设置 > 单点登录」页面，点击「本系统账号登录外部」的「前往配置」按钮，即可跳转至产品中心配置集成应用。

4. 创建集成应用

在产品中心创建集成应用，生成身份凭证，供外部系统对接使用。

1）进入「管理后台 > 基本信息 > 产品中心」页面。单击「+ 集成更多应用」

⚠️ 注意：每个企业最多可创建 50 个集成应用。

3）弹出「配置集成应用」对话框，配置项说明如下：

配置项	说明	是否必填
应用名称	集成应用的名称，自定义	必填
应用描述	对集成应用用途的简要说明	必填
应用图标	集成应用在产品中心显示的图标	可选
可信域名	用于声明允许嵌入简道云页面的外部系统域名。填写后，简道云将通过该域名验证嵌入请求是否来自已授权的集成应用填写时请注意以下规则： 1）仅填写域名本身，不填写协议头。例如填写 a.example.com，而非 https://a.example.com 2）域名不会自动匹配其子域名。如需信任子域名，须逐一单独填写。例如填写 example.com，无法匹配 a.example.com 3）如需填写多个域名，使用英文逗号「,」分隔，逗号前后不加空格。示例：a.example.com,b.example.com 4）如部署了中转服务（用于接收简道云 code、获取用户信息及跳转至第三方系统），此处应当填写中转服务的域名，而非第三方系统的域名。例如集成的第三方系统域名为 finebi.com，中转服务域名为 sso.bi.com，此处应当填写 sso.bi.com	必填
Suite ID	系统自动生成的集成应用唯一标识，供第三方系统接入使用集成应用创建完毕后自动生成，不支持修改	自动生成
Suite Secret	系统自动生成的密钥，用于调用简道云 API 换取用户信息集成应用创建完毕后自动生成，支持复制、查看明文和重置操作（详见下方说明）	自动生成
应用首页	外部系统的首页地址。配置后，在「产品中心」单击「进入应用」可直接跳转到该地址。填写时请注意以下规则： 1）填写包含协议头的完整访问地址。例如：https://a.example.com/home/ 2）如部署了中转服务（用于接收简道云 code、获取用户信息及跳转至第三方系统），此处应当填写中转服务的地址，而非第三方系统的首页地址。（中转服务到第三方系统首页的跳转，应当在中转服务中配置）例如集成的第三方系统首页为 https://demo.fanruan.com，中转服务地址为 https://sso.fanruan.com/sso.php，此处应当填写 https://sso.fanruan.com/sso.php	可选

4）单击「创建」，集成应用创建成功。

5. 获取 Suite 信息

Suite ID 和 Suite Secret 是集成应用的核心凭证，在集成应用创建时由系统自动生成。

Suite ID：相当于集成应用的「账号」，标识身份来源，在第三方系统对接时作为标识符使用
Suite Secret：相当于集成应用的「密码」，用于服务端调用简道云 API 时验证身份

1）集成应用创建成功后，点击「编辑」按钮。

2）进入集成应用配置详情页，即可查看自动生成的 Suite ID 和 Suite Secret

对象	支持的操作
Suite ID	复制：单击复制图标，将 Suite ID 复制到剪贴板
Suite Secret	复制：单击复制图标，将 Suite Secret 复制到剪贴板查看：单击眼睛图标，以明文显示 Suite Secret 重置：单击刷新图标，重新生成 Suite Secret。重置后，原有 Secret 立即失效，已配置的外部系统需要使用新的 Secret 重新对接

⚠️ 注意：重置 Suite Secret 会导致已对接的外部系统单点登录失效，请谨慎操作。

6. 管理集成应用

集成应用创建后，在产品中心的「其他集成应用」区域以卡片形式展示。

企业创建者和系统管理员可查看、管理已创建的集成应用。

	操作	说明
1	启用与停用集成应用	每个集成应用卡片右侧有一个开关按钮，用于控制该应用的单点登录能力。开启（开关为绿色）：单点登录能力可用，用户可以通过简道云账号免登录访问该外部系统关闭（开关为灰色）：单点登录能力停用，嵌入页面无法实现免登录
2	进入集成应用首页	如果配置了应用首页地址，应用卡片底部显示「进入产品 →」链接。单击后跳转到外部系统的首页。
3	编辑集成应用配置	1）鼠标悬浮于集成应用卡片，单击「编辑」按钮 2）系统弹出「配置集成应用」对话框，显示当前集成应用的配置信息。 3）修改需要更新的配置项。修改应用名称和应用描述不影响已有的单点登录配置重置 Suite Secret 会导致已配置的外部系统单点登录失效，需要使用新的 Secret 重新对接 4）单击「保存」生效。
4	删除集成应用	删除集成应用后，该应用的单点登录能力立即停用，效果等同于关闭开关。删除操作不可撤销。删除后，所有通过该集成应用实现的嵌入页面免登录功能将失效。

7. 下一步：配置免登录访问集成应用

集成应用创建完毕后，第三方系统的服务端需要实现接收简道云跳转、验证用户身份并完成自动登录的逻辑。

实现原理请参考：集成应用免登对接说明
实现示例请参考：集成应用免登对接示例