门户集成

一、应用场景

YonSuite/YonBIP/友空间集成三方系统页面

二、添加集成开发应用

管理员用户登录YonBIP/YonSuite 。注意必须是企业管理员用户，否则没有应用管理节点权限。选择租户，点击左上角的快捷应用中的 “数字化建模”-“系统管理”-“我的应用”，点击“我的应用”菜单，如下图所示：

三、接口授权

• 需要调用根据code获取免登信息，获取当前登录YonSuite/YonBIP/友空间的用户信息
• 首先要进行接口授权操作

四、添加自建服务

• 选择服务列表，点击添加自建服务，根据提示填写相关信息。
• 注意集成免登策略要选择友空间。只有勾选了友空间使用者在点击服务节点时地址信息才会拼接免登code
• 添加的服务地址要求是H5页面且外网可访问

五、编码逻辑

• 按照上述操作配置后，会在对应客户端生成节点（菜单）。点击后链接上会携带code参数（临时身份信息，只能用一次，有效期1分钟）
• 取得code后调用【根据code获取免登信息】即可获取当前登录YonSuite/YonBIP/友空间的用户信息。（按照下图操作查看接口文档信息）

• flag传true可以返回用户手机号和邮箱信息

• 在外部应用中将yonbip用户信息及租户id和外部应用的用户信息绑定，三方系统获取用户信息后处理登录相关逻辑。

• 三方系统在取到YS的用户信息后，自己判断在自身系统中是否存在对应的用户信息，如果存在则跳过登录逻辑。

六、接口调用SDK提供

【根据code获取免登信息】接口调用需要鉴权，以下提供鉴权相关SDK

6.1、标准SDK

https://c2.yonyoucloud.com/iuap-api-management/ucf-wh/console-fe/open-home/sdk-center/index.html?from=openplatform#/

6.2、未找到对应语言SDK

目前需按照下列文档加密原理自行编码，后续平台会逐渐提供更多语言SDK包

https://c2.yonyoucloud.com/iuap-api-management/ucf-wh/console-fe/open-home/index.html#/doc-center/docDes/doc?code=open_jrwd&section=022c941650ae4989af7dd6ac7fd4d412

6.3、AppKey、AppSecrect获取