1. 概述

本产品提供了钉钉集成的能力，目前仅私有部署版本支持钉钉小程序集成功能。通过配置可以实现本产品与钉钉的打通，实现免密登录，登录后可在钉钉端轻松查看报告。

通过在钉钉开发者后台和产品后台的配置，即可实现钉钉集成功能。

2. 钉钉开发者后台配置

2.1 创建企业小程序

（1）企业使用管理员账号登录钉钉开发者后台https://ding-doc.dingtalk.com/，登录后进入应用开发-企业内部开发；

（2）点击[创建应用]，进入创建企业自主开发小程序的流程，然后填写您公司的应用名称，上传logo，填写应用简介；选择开发方式为企业内部自主开发；填写完以上基本信息后，点击[确定创建]；

（3）创建完成后，忽略页面的提示引导，进入[开发管理]-[修改]；

（4）服务器出口IP需填写本产品部署的服务器出口IP，其他项目选填；

（5）完成后点击[保存]，即成功创建小程序。

2.2 发布小程序

创建完成后，点击应用信息的[查看详情]按钮，可看到小程序的三个重要参数：AgentId、AppKey、AppSecret。

特别注意：这三个参数后续将填写至有数管理后台！

接着，进行如下的相关设置：

（1）人员设置。添加开发人员，将企业域内的员工添加为应用开发人员。

（2）设置安全域名。事先设置一个可以进行网络通信的通讯域名和可以被 webview 组件加载的 URL 的域名或IP。

注意：每个企业的具体域名可联系我方的技术支持同事进行设置。

（3）版本管理。在版本管理tab页下上传本产品小程序的代码，即可发布小程序的版本；添加小程序后，可在如下页面管理开发版本，并设置小程序的可用范围。

（4）接口权限。为了保证小程序的正常登录及其他功能，必须在权限管理页下申请开通企业通讯录权限。

3.产品后台配置

在产品管理后台的设置页面，可以对钉钉集成的开启进行控制，若要在钉钉中启用小程序，首先在[钉钉集成设置]下打开集成开关，其次填写正确的配置信息：钉钉开发者后台提供的AgentId、AppKey、AppSecret。

用户与钉钉账号的匹配

用户在钉钉上首次登录小程序后，在企业域管理-人员信息页面的人员列表可以看到已匹配用户的基本信息，且该用户下次即可在钉钉端免密登录小程序。

对于部分用户，管理员可手动[设置钉钉匹配]，通过钉钉用户的手机号或者姓名与用户进行匹配，匹配完成后的用户可以直接在钉钉端免密登录小程序。