变更记录

1 简介

文档介绍苍穹与钉钉自建应用的集成，从而轻松实现在钉钉客户端和App一键免登苍穹系统，无需输入苍穹账号密码即可登录系统，方便用户处理业务，提升办公效率。

2 适用版本

金蝶云苍穹 V3.0以上（苍穹公有云私有云均适用）

3 系统路径

V6.0及以上：【系统服务云】→【第三方服务设置】→【企业协同软件配置】→【钉钉】

4 操作说明

4.1 创建钉钉H5微应用

4.1.1 登录钉钉管理后台

在钉钉客户端，使用钉钉管理员账号登录钉钉【管理后台】。

4.1.2 创建H5微应用

1）进入【管理后台】，点击【工作台】，下滑到页面最下方，在【自建应用】模块，点击【自建应用】超链接，进入【钉钉应用开发平台】。

2）在最上方导航栏，点击【应用开发】页签，在【企业内部应用】点击【钉钉应用】菜单，在右边页面，点击【创建应用】按钮。

2）填写应用名称、应用描述，上传应用图标，点击页面最下方的【保存】按钮，完成应用的创建，自动跳转应用详情页面。

4.1.3 获取应用凭证信息

1）在钉钉应用列表页面，选择对应的应用，点击应用名称，进入应用详情页。

2）在凭证与基础信息中获取应用的 AgentId 和 AppKey。

4.1.5 获取企业ID

点击【钉钉开放平台】页面的右上角头像，可以看到钉钉的 CorpId（企业ID）。

4.1.6 配置应用首页地址

1）在应用详情点击【添加应用能力】，选择【网页应用】。

2）在【网页应用】中分别配置免登跳转苍穹的【应用首页地址】和【PC端首页地址】。

• v7.0及以上版本，在苍穹“系统服务云--第三方服务设置--企业协同软件配置--钉钉--新增/编辑界面”一键生成
  

• v6.0及以下版本，需手动构造

4.17 开通接口权限

点击【权限管理】菜单，开通相关的接口权限。

4.18 设置出口IP（非必填项）

在应用详情中选择安全设置，填写服务器出口IP。此处设置的IP为白名单，可不设置，如设置须填写外网IP。

4.1.9 应用发布

进入应用的版本管理和发布，创建新版本，录入相关信息点击保存完成发布。

4.2 MC租户管理中心配置

• v7.0及以上版本，在苍穹“系统服务云--第三方服务设置--企业协同软件配置--钉钉--新增/编辑界面”配置免登插件，默认“标准”无需配置，如有二开插件，选择“自定义插件”并将插件名填写至右侧输入框中。
  

• v6.0及以下版本，请按4.2.1~4.2.3的步骤操作

4.2.1 登录MC管理中心

登录MC管理中心，找到对应的租户，点击租户ID进入租户配置界面。

4.2.2 配置免登插件

在租户配置项增加配置项，配置项名称填写authtication.apps，配置项值填写kd.bos.login.thirdauth.app.dingding.DDAuthtication，如同时配置了多个第三方应用，如企业微信、weblink时，多个配置项值中间以英文逗号隔开。

配置完成后，点击保存。

4.2.3 发布集群

点击左侧栏菜单【集群管理】，选择集群，点击发布。

4.3 苍穹端配置

4.3.1 钉钉配置列表

使用管理员账号登录苍穹系统，进入钉钉第三方应用配置列表。

4.3.2  钉钉应用配置

新增钉钉配置，输入应用标识和应用秘钥，相关信息获取可参考<4.1.4>和<4.1.5>步骤，点击保存。

4.4 免登验证

打开钉钉工作台，找到配置好的免登应用，如果能正常打开苍穹对应的页面，则代表免登成功。

注意：若访问时，需登录则代表没有免登成功，请按上述步骤检查。

5 配置检测

仅V7.0及以上版本支持，在苍穹“系统服务云--第三方服务设置--企业协同软件配置--钉钉”列表或新增/编辑界面，点击【配置检测】按钮，进行关键配置检测。

6 异常日志

仅V7.0及以上版本支持，用户免登失败时，在苍穹“系统服务云--第三方服务设置--企业协同软件配置--钉钉”列表，自动记录异常日志，帮助管理员排查异常配置问题，“日志描述”给出相关错误和指导。

7 常见问题

• 钉钉集成常见问题排查思路或解决办法 点击查看>

• 第三方应用集成通用问题 点击查看>