选择钉钉体系，可同步钉钉部门与成员，更快建立用户体系，需求反馈、进度提醒、消息通知与协作更高效。

以下是详细的集成步骤，为了平台与钉钉的正常集成，每一步都不可跳过。

由于钉钉对企业内建应用进行了IP限制，所以需要客户自己搭建出代理服务器。配置代理服务器的目的是为了解除IP限制。

注1：该代理服务器需要部署在公网环境中，具备公网IP，能够被外网访问，不可部署在内网环境内（包括公司内网、家庭内网等等），否则会无法完成钉钉配置。

注2：如果不具备公网环境的服务器，可以在华为云、阿里云、腾讯云上购买带有ip地址的服务器

下面以在window系统内安装Nginx为例。

2.1 下载Nginx

点击此处打开下载地址，点击下载Stable version （稳定版本）。版本略有差异，这里以 nginx/Windows-1.18.0 为例。

2.2 启动Nginx

1、下载完成后解压到C:\目录下，解压后打开文件夹，在文件夹中按住Shift点右键，选“在此处打开命令窗口”。

2、在命令窗口中输入start nginx，按回车enter，即可启动nginx。如操作失败，还可查看cmd启动nginx的其他方法，点击跳转

3、在浏览器内输入http://127.0.0.1出现 Nginx 欢迎页面即部署成功。

• 如果出现的是以下的页面，点击跳转查看具体步骤
  

    

2.3 修改配置文件

• 找到文件C:\nginx-1.18.0>conf>nginx.conf，以写字板/记事本打开

• 找到图示位置

• 将选中代码替换成如下代码

    ##### 下面是替换部分 #####

    location / {

        proxy_pass https://oapi.dingtalk.com;   #转发地址，以钉钉为例 https://oapi.dingtalk.com，微信类似 https://qyapi.weixin.qq.com

    }

    ##### 上面是替换部分 #####

•  更改后如图所示

2.4重启 Nginx

（如何重启可参考https://www.jianshu.com/p/01f3626cf25d），

1、在浏览器内输入http://127.0.0.1/gettoken，

2、在浏览器内输入http://IP地址/gettoken，均有如下钉钉返回信息即表示代理服务器配置成功。

3、若没有显示如下钉钉返回信息，则需要关闭windows防火墙，详细操作点击跳转

2.5 配置成功

成功获取代理服务器IP地址，将IP地址填入数知鸟应用界面代理服务器输入框中即可。

注意：为了保持钉钉与平台集成的正常运行，windows防火墙需处于关闭状态，如需打开防火墙，请查看开启防火墙并打开80端口帮助文档，点击此处跳转

3.1在数知鸟平台启用钉钉体系

在用户管理页面，选择启用“钉钉”

• 出现以下页面，将刚才的IP地址填入【代理服务器地址】中，其他字段需要在钉钉管理后台获取：

• 格式为http://IP地址  例：http://123.12.12.12

3.2 在钉钉管理后台获取所需字段

钉钉的管理员登录钉钉管理后台

3.2.1点击【工作台】，下滑找到并点击【自建应用】

3.2.2创建应用

在跳转的【应用开发】页面点击【H5微应用】，点击【创建应用】

• 如图所示填写创建应用详情

注：应用类型、开发方式务必按照图中方式填写

• 应用名称：数知鸟

• 应用logo如下：

3.2.3创建应用成功后，进行必要配置

1、点击【开发管理】，点击修改，将代理服务器IP的数字部分填入 注意：仅填数字部分，如图所示

2、应用首页地址填写 https://shuzhiniao.com/  或 将图示部分复制粘贴至文本框 此处为暂时填写，后续会进行修改

3、点击保存

3.2.4点击【凭证与基础信息】，获取"AgentId"、"AppKey"、"AppSecret"。

3.2.4点击【首页】，获取"Corpld"

3.3在数知鸟中填入获取字段，点击【下一步】

• 在数知鸟平台中点击【下一步】后出现如下页面

3.4在钉钉后台配置应用

回到钉钉管理后台，对”数知鸟“应用进行必要配置

3.4.1应用开发>H5微应用>数知鸟

3.4.2修改【开发管理】页面

1. 将数知鸟平台获取的”应用首页地址“和”PC端首页地址“填入相应的地方。

2. 点击保存
   

3.4.3添加权限接口

1. 点开【权限管理】页面，点击【添加接口权限】

   

2. 将”通讯录只读权限“、”手机号码信息“、”邮箱等个人信息“接口权限添加，点击【确认】

3. 完成后如图所示

4. 注意：此处的权限范围为同步至平台的用户，即数知鸟平台内用户，请谨慎设置

3.4.4发布应用

1. 点击【版本管理与发布】页面，点击【确认发布】

2. 点击确认发布后，自动跳转至如下页面，设置应用可适用范围。点击【保存修改】注意：此处范围需与【权限管理】中的范围一致

3.5返回数知鸟，点击配置

即可配置成功

• 在钉钉应用【工作台】内即可看到”数知鸟“应用

• 到此，您已经完成了钉钉和数知鸟平台的集成。

• 如果出现的是以下的页面，按照以下步骤操作
  

    1、开始->运行->services.msc

    2、找到 World wide web publishing service右击->停止

    3、刷新页面，即可正常

1、打开控制面板>系统和安全>windows防火墙，点击高级设置

2、点击左侧【入站规则】后点击右侧“操作”下的【新建规则】

3、按照以下图示新建规则

注意：此处填写80

注意：名称填写 nginx服务

4、创建成功后如图所示

5、关闭【高级选项】页面，回到【windows防火墙】页面，点击【启用或关闭windows防火墙】

6、点击图中框选的两处“启用windows防火墙”

7、如图所示，则防火墙已经打开成功

数知鸟https://shuzhiniao.com