IP-Guard申请审批支持钉钉平台使用说明

IP-Guard文档

如何将IP-Guard的申请审批功能与钉钉平台结合，包括在钉钉创建微应用、配置Web服务器、设置管理员账号以及在钉钉上进行审批的操作步骤。
申请审批支持钉钉平台使用说明
一、功能简介
Web 控制台上申请审批与钉钉平台关联，在钉钉上创建一个小应用，可以通过这个应用
进入审批系统进行查看和审批申请相关操作。客户端通过相关加密申请操作后，会在钉钉收
到相关申请通知消息，点击消息进入即可进行审批。
二、安装部署
2.1 web 服务器映射到外网
1、使用内网穿透软件将访问 web 控制台的链接映射成外网链接:
http://gz3.tec-development.com:8087
2.2 钉钉创建微应用
1、登录钉钉管理后台：https://oa.dingtalk.com/index.htm#/login后，点击“工作台” ->
“自建应用” -> 将跳转到钉钉开发平台。


2、填写应用名称、应用简介和上传应用 logo 后，点击【下一步】



3、配置开发信息(红色*为必填项)：

• 应用首页链接
  

格式：http(s)://域名:端口/ipg/appr/signin/main，其中域名和端口替换成 web
服务器映射出来的链接。例如：web 服务器映射出来的外网链接，域名：gz3.tec-development.com    端口：8087
则首页链接为 http(s)://gz3.tec-development.com:8087/ipg/appr/signin/main

• 服务器出口 IP Web 服务器的域名对应的 ip。
• 可使用范围可以使用该微应用的人员。
  

4、创建完微应用后，添加扫码登陆应用授权，登录钉钉管理后台后，点击应用开发 ->
移动接入应用 -> 创建扫码登录应用授权

5、填写授权信息

• 授权 Logo 地址
  

进入钉钉开发平台后，选择应用开发 -> 微应用管理 -> 点击设置图标 -> 基础信息 ->
查看详情，在图标上点击右键，复制图片地址。

• 回调域名
  

Web 映射出来的链接域名，即微应用例子中的 http://gz3.tec-development.com/，域名
后面需要加上斜杆“/”
2.3 web 服务器配置

1、在 web 控制台安装目录 ../www/ipg/下手动创建 spconfig.ini 配置文件，内容如下：

• appr_type
  

指审批类型，2 为钉钉审批。

• mes_url
  

格式：http(s)://域名:端口/ipg/ ，其中域名和端口替换成 web 服务器映射出来的链接。
例如：域名：gz3.tec-development.com     端口：8087
则得到路径：http://gz3.tec-development.com:8087/ipg/

• mes_lang
  

发送审批通知消息的语言，支持简体中文（zh-cn）、繁体中文（zh-tw）、英文（en-us）。

• w_agentid、w_appkey、w_appsecret
  

进入钉钉开发平台，选择“应用开发” -> “微应用管理” -> “点击设置图标” -> “基
础信息” -> “查看详情”。
下图中圈出来的 AgentId、AppKey 和 AppSecret 即分别为 w_agentid、w_appkey、w_appsecret。

• s_appid、s_appsecret
  

进入钉钉开发平台，选择“应用开发” -> “移动接入应用” -> “扫码登录使用的 app ID、appSecret”。
图中圈出来的 appId、appSecret 即分别为 s_appid、s_appsecret 的值

2、 修改 web 控制台安装目录下 ../www/ipg/server/config.ini 这个配置文件。手动添加下图红框中内容，8088 端口修改为对应的 web 服务器端口

3、修改完配置文件后，要重启 owss 服务

三、管理员账号设置
如果想要钉钉某成员能收到审批通知，则需要在 IP-guard 控制台为该成员添加一个管理员账号，账号与该用户在钉钉上的 UserID 必须一致。
3.1 钉钉员工的 UserID
1、登录钉钉管理后台后，点击“通讯录”->“内部通讯录管理”，点击需要查看的员工栏，右侧最上方的就是员工的 UserID

3.2 添加管理员账号
1、登录 IP-guard 控制台，选择工具->账号，添加钉钉对应的 UserID 账号 manager2613。

2、给 manager2613 添加系统管理员权限后，使用的是默认审批流程，也可以在 IP-guard
控制台的“申请管理”-“加密申请管理”-“审批流程管理”里自定义审批流程。
四、钉钉审批
4.1 授权微应用
1、手机上登陆钉钉后，选中底部导航栏的工作位置，第一次进入工作界面时会让你进行一些设置选择，一直默认跳下去即可。

2、进入工作界面后，找到我们前面创建的 ipguad 审批微应用点击进入，第一次进入时会提示：ipguard 审批请求你授权，
同意授权以后自动登录进入审批首页。下次进入此应用不会再询问。

3、授权进入后就可以看到桌面申请和加密申请

4.2 审批
1、当客户端提交了一个解密申请，在钉钉上会收到该解密申请的通知。

2、点击申请通知进入可以查看申请信息并进行审批，可以预览或下载文件(安卓系统进
行下载文件会跳转到浏览器登录后才能下载，ios 系统不支持下载)