私有云云之家免登苍穹配置
1. 简介
本文档介绍苍穹与私有云云之家应用的集成，从而轻松实现在云之家客户端和App一键免登苍穹系统，无需输入苍穹账号密码即可登录系统，方便用户处理业务，提升办公效率。
2. 适用版本
金蝶云苍穹【公有云&私有云】 V3.0.001以上
3. 操作说明
3.1云之家创建轻应用
3.1.1 登录云之家管理后台
使用云之家管理员账号登录云之家管理后台，点击右上角的【管理中心】进入管理中心页面，点击左侧菜单的【应用中心】下的二级菜单【轻应用管理】。
3.1.2 云之家开发者平台
在应用应用管理页面，点击右上角的【开发者平台】进入开发者平台页面。
3.1.3 创建应用
1）在开发者平台页面，点击右上角【新建应用】创建新应用。
2）在弹出的新建应用界面填写应用名称、应用简介，设置所属组织，点击【确定】创建应用。
3.1.4 获取App ID和 App Secret
在<3.1.3>步骤创建完应用后，系统自动跳转至应用详情界面（如没有自动跳转，请从应用列表点击【管理】进入），在详情信息中查看获取轻应用的App ID和 App Secret，用于苍穹端配置和构造应用访问URL使用。
3.1.5 配置访问地址
1）在应用详情界面，点击左侧栏菜单【功能开发】，点击开启“轻应用”。
2）在访问地址栏设置移动端、网页端、桌面端的访问地址，用于在云之家点击该应用时跳转苍穹的页面地址。
构造应用主页的URL方法： 按如下格式拼接苍穹页面地址：
https://xxx.xxxx.xxx/index.html?formId=xxxxx&accountId=xxxxx&appid=xxxxx
https://xxx.xxxx.xxx/mobile.html?form=xxx&accountId=xxxxxx&&appid=xxxxx 注意：示例中的URL蓝色字体为需替换的实际域名和参数值，黑色字体为固定参数和参数值，URL不要存在空格等多余字符
|
3.2 MC苍穹管理中心配置
3.2.1 登录MC管理中心
登录MC管理中心，点击左侧栏菜单【租户列表】，在租户列表中找到对应的租户，点击租户ID进入租户配置界面。
3.2.2 配置免登插件
1）在租户配置项增加配置项，配置项名称填写authtication.apps，配置项值填写kd.bos.login.thirdauth.app.yzj.YZJPrivateAppAuthticationAuth2，如同时还集成企业微信、WeLink等多个第三方应用，多个插件（配置项值）中间以英文逗号隔开。
2）配置完成后，点击保存。
3.2.3 配置MC公共参数
1）点击左侧栏菜单【基础数据维护】下的二级菜单【环境公共配置项】，在环境公共配置项页面选中login.yzjprivatecloud.properties 目录
2）新增配置项，按下表配置5个参数：
| 参数 | 名字 | 编码 | 值 |
| 云之家访问地址 | 租户ID.WBHost | 租户ID.WBHost | 根据云之家的实际值填写 |
| 云之家地址 | 租户ID.XtHost | 租户ID.XtHost | |
| 工作圈 | 租户ID.mid | 租户ID.mid | |
| 云之家轻应用App ID | 租户ID.appid | 租户ID.appid | |
| 云之家App Secret | 租户ID.AppSecrest | 租户ID.AppSecrest.appid值 |
App Secret的编码后缀需要加上appid值，如租户ID为“hwbosH1_test”，appid是500660502，则App Secret编码为“hwbosH1_test.AppSecrest.500660502”
说明：当需集成多个云之家轻应用时，只需要新增追加最后一行App Secret参数，前面的配置无需添加和修改，即：租户ID.AppSecrest.appid=XXXXXXXXX。
3.2.4 发布集群
点击左侧栏菜单【集群管理】，选择集群，点击发布。
3.3 免登验证
打开云之家客户端，进入云之家工作台，点击【全部应用】，找到并打开前面配置好的应用。如果能正常打开苍穹的单据页面，则代表访问成功。
如页面提示“账号不存在”，请检查是否完成苍穹人员和云之家人员同步。请参考《云之家差异对比》
4 常见问题
私有云云之家免登苍穹配置
本文2024-09-23 00:33:34发表“云苍穹知识”栏目。
本文链接：https://wenku.my7c.com/article/kingdee-cangqiong-140239.html
