#单点登录-用友认证-YonBIP

##适用产品

YonBIP

##核心配置参数及来源

参数	是否必填	来源	示例	参数说明
appKey	是	三方系统	企业管理员登录用友云工作台，创建应用	API 授权中的 appKey
appSecret	是	三方系统	-	API 授权中的 appSecret
授权地址	是	三方系统	https://dbox.diwork.com	获取 Token 接口域名前缀 /API 鉴权接口域名前缀
thirdUcId	是	三方系统	h8AAA	-
跳转地址	是	三方系统线下提供	https://dbox.diwork.com/login?tenantId=h8AAA	固定值：https://dbox.diwork.com/login?tenantId= 租户 ID 通过 YonBIP 接口【获取租户环境信息】获取
单点登录地址	是	三方系统线下提供	https://euc.yonyoucloud.com	固定值

##效果说明

1. 调用接口获取token
   

2. 调用个接口根据token获取code
   

3. 将code拼接到访问地址URL中
   

##YonBIP参数获取说明

https://doc.yonisv.com/mybook/developergame/single-login/1-/single-login.html (opens new window)

对接流程图

###新增集成应用

进入【集成认证中心】节点，点击新增，按照下图配置后点击保存

创建完成后会自动生成认证中心编码 (后续需要使用：thirdUcId)

获取临时登录code

集成认证中心获取登录临时code授权

https://doc.yonisv.com/mybook/selfbuild/1-/selfbuild_enter.html (opens new window)

查看接口文档调用获取临时code

thirdUcId和userId必填

thirdUcId参考 【二. 新增集成应用】 后产生的编码

userId 三方用户唯一标识，用来同用友账户信息绑定。

拼接单点地址

目标地址拼接格式参考{}里面的参数均需要替换成实际值：

https://euc.yonyoucloud.com/cas/thirdOauth2CodeLogin?thirdUCId={thirdUcId}&code={code}&service={service} (opens new window)

参数	描述
thirdUcId	3.2 参数相同
code	3.2 接口返回结果
service	单点控制台地址核心 2：https://c2.yonyoucloud.com/login?tenantId={tenantId}%EF%BC%8C%E9%9C%80%E8%A6%81%E8%BF%9B%E8%A1%8Curlencode%E8%BD%AC%E4%B9%89%E3%80%823.1、入门示例文档中
tenantId	租户标识，用于标识租户信息，具体获取方式参考 3.1 及入门示例文档中 4.2 租户 ID 获取部分

---

转换出的最终单点地址举例：

https://euc.yonyoucloud.com/cas/thirdOauth2CodeLogin?thirdUCId=hpoc36r6&code=b4bcc87804ef45fb93dbafdf71ffbbce&service=https%3A%2F%2Fc2.yonyoucloud.com%2Flogin%3FtenantId%3Daen06kxy (opens new window)

e. 五、单点登录

使用四章节拼接的地址放入浏览器即可实现单点效果。 首次单点需要输入用友系统用户名密码（三方系统userId和用友系统用户绑定）,后续再次单点不需要再次输入直接进入目标地址service。

绑定后即可跳转目标地址

f. 六、账号解绑

如果需要解除三方userId和用友账户的绑定关系，可以按照以下步骤操作：

编撰人：pengfx

快速跳转

• 对接流程图
• 获取临时登录code
  • 集成认证中心获取登录临时code授权
  • 查看接口文档调用获取临时code
• 拼接单点地址