IP-GUARD申请审批支持企业微信使用说明

IP-Guard文档

将IP-GUARD审批系统与企业微信整合，详细阐述了从功能简介、安装部署到管理员账号设置、企业微信审批操作的全过程，包括设置可信域名、创建微应用、配置服务器文件和关联多个IP-guard服务器等步骤。

申请审批支持企业微信使用说明
一、功能简介
Web 控制台上申请审批与企业微信关联，在企业微信上创建一个小应用，可以通过这个
应用进入审批系统进行查看和审批申请相关操作，并且支持企业微信可以同时关联多个
IP-guard 服务器。在企业微信上可以同时接收不同 IP-guard 服务器发来的审批通知并进行审批。
二、安装部署
2.1 web 服务器映射到外网
1、使用内网穿透软件将访问 web 控制台的链接映射成外网链接:
https://www.itggg.com:36204
2.2 创建微应用
1、登录企业微信管理后台：
https://work.weixin.qq.com/wework_admin/loginpage_wx?from=myhome，扫码登录即可。
点击“应用与小程序” -> “创建应用”。




2、填写基础信息，创建应用。

3、创建成功后，设置可信域名和应用主页







可信域名：web 控制台的外网访问链接为 http://25306b7t80.qicp.vip:36204
，则可信域名为 25306b7t80.qicp.vip:36204。
注意：可信域名不包含可信域名不能包含协议头，不支持 IP 地址及短链域名。

应用主页：
格式：http://域名:端口/ipg/appr/signin/main，其中域名和端口替换成 web 服务器映射出来的链接
则应用主页为 https://www.itggg.com:36204/ipg/appr/signin/main
2.3 web 服务器设置
1、在 web 控制台安装目录 ../www/ipg/下手动创建 spconfig.ini 配置文件，内容如下：

• appr_type
  

指审批类型，1 为企业微信审批。

• mes_url
  

格式：http(s)://域名:端口/ipg/ ,其中域名和端口替换成 web 服务器映射出来的链接

例如：域名：www.itggg.com    端口：36204

则得到路径：https://www.itggg.com:36024/ipg/

• mes_lang
  

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

• Corpid
  

进入企业微信管理后台，点击“我的企业”->“企业信息”->“企业 ID”

• Agentid、agent_secret
  

在“应用与小程序”中找到刚创建的微应用进入






红框中的 Agentid 和 Secret 便是配置文件中的 Agentid 和 agent_secret。

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


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


2.4 管理员账号设置
如果想要企业微信某成员能收到审批通知，则需要在 IP-guard 控制台为该成员添加一
个管理员账号，账号与该用户在企业微信上的账号必须一致。
2.4.1 企业微信用户账号
1、登录企业微信管理后台后，点击“通讯录”->点击选择要查看的用户，可看到账号是什么

2.4.2 添加管理员账号
1、登录 IP-guard 控制台，选择工具->账号，添加企业微信对应的账号 ZhongZhengLiang。




2、给 ZhongZhengLiang 添加系统管理员权限后，使用的是默认审批流程，也可以在
IP-guard 控制台的“申请管理”-“加密申请管理”-“审批流程管理”里自定义审批流程。
三、企业微信审批
3.1 查看申请
1、手机上登陆企业微信后，选中底部导航栏的工作位置，选择“工作台”界面，可看
到添加的微应用 test2。




2、进入 test2 后可看到各申请情况。

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




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





四、关联多个 IP-guard服务器
重复前面第二部分的前提部署，新创建一个微应用“审批 2”，并配置相关项关联另外
一个 IP-guard 服务器和 web 控制台。
配置完后，此时分别在两个微应用所关联的 IP-guard 服务器上的客户端提交解密申请，
在企业微信上可看到来自两个微应用发来的申请通知。




注意：
1、目前只支持将加密申请的通知消息发送到企业微信上，桌面申请暂不支持推送消息到企业微信；
2、加密申请的多级审批流程中只支持在第一级中去推送通知，后面的二级三级流程不会推送通知消息到企业微信；
3、委托审批不会推送通知消息，如 admin 委托审批权限给 zhongzl，但 zhongzl 不在当前审批流人里面，企业微信上不会推送审批通知消息给 zhongzl