INFO-企业微信告警配置

适用模块

报警组件 easyalert

具体说明

官方文档 https://developer.work.weixin.qq.com/document/path/90664
企业微信发给个人，非群组
这里提供一种常见的接入公司业务系统给的方法：
1. 企业微信的管理员账号建立一个报警应用， 给出应用secret以及公司ID（corpId），开启企业微信通讯录读权限，提供secret；
2. 获取企业微信部门列表，进而获取全部用户，根据用户的手机号或email 与猛犸系统进行匹配，同步企业微信账户到数据库中
3. 接入应用通知服务

使用示例

一、部署前准备：
需要在企业微信上提供相关服务，具体操作请查看附件文档，需要获得以下参数
host 企业微信API前缀 : https://qyapi.weixin.qq.com channel.info.deal.wecom.host
corpId 企业微信 企业ID : channel.info.deal.wecom.corpId
通讯录secret : channel.info.deal.wecom.address.secret
报警应用secret: channel.info.deal.wecom.alert.secret
报警应用agentId: wecom.agentId
注意1：一旦接入方更改了相关信息，需要重新配置相关属性
注意2：当企业微信中出现了两个用户的密码或者邮箱是相同的，会导致用户信息错乱
删除其中一个用户，即要保证企业微信中的用户，电话和email唯一性，然后等待用户信息刷新
企业微信报警逻辑：
1. 维护token：企业微信维护两个token在数据库config表中，通讯录Token和报警应用Token，1小时更新一次。
2. 用户管理：由通讯录token获取企业微信所有部门ID，进而获取到全体用户信息，与本地数据库同步企业微信账号，每5分钟同步一次，新注册用户要等待5分钟。
3. 发送消息：企业微信账号维护在user表的moreinfo中，plugin通过token和企业微信账号发送消息，限制3000字符

二、企业微信设置
需要获得参数：
host 企业微信API前缀 : https://qyapi.weixin.qq.com channel.info.deal.wecom.host
corpId 企业微信 企业ID : channel.info.deal.wecom.corpId
通讯录secret : channel.info.deal.wecom.address.secret
报警应用secret: channel.info.deal.wecom.alert.secret
报警应用agentId: wecom.agentId
注意:  被通知人在企业微信中，至少需要 email 或者 phone 与猛犸系统一致

1 企业微信 企业ID： corp ID

2 通讯录：企业微信—管理工具—通讯录同步—设置通讯录权限，获取秘钥，开启API接口同步
参数说明：
Secret : channel.info.deal.wecom.address.secret

3 报警应用：应用管理——创建应用——报警系统，可见范围选择根部门（报警通知人需要在这个范围内）—— 报警系统应用详情
(需将easylert节点ip加入至企业可信ip)
参数说明：
AgentId: wecom.agentId
Secret: channel.info.deal.wecom.alert.secret

三、easyops设置

1、在easy_alert数据库SQL命令执行：
INSERT INTO `channel`(`id`,`name`,`clz`,`text`,`enable`) VALUES(9,'wecom','com.netease.bdms.smilodon.alert.plugin.wecom.WecomSender','企业微信',1);

2、server配置：
host 企业微信API前缀 : https://qyapi.weixin.qq.com channel.info.deal.wecom.host
corpId 企业微信 企业ID : channel.info.deal.wecom.corpId
通讯录secret : channel.info.deal.wecom.address.secret
报警应用secret: channel.info.deal.wecom.alert.secret
上述信息配置步骤二所获取结果
user_info_supple_clz: com.netease.bdms.smilodon.alert.external.suppleUserInfo.WecomUserInfoSuppler

3、advanced配置：
wecom.host: https://qyapi.weixin.qq.com
wecom.agentId 采用步骤二获取应用id

4、更新当前配置组-批量应用该版本-同步配置并重启服务

作者：林帅