1、企微配置可信域名
2、企微获取成员userID
3、企微获取用户敏感数据
4、企微配置回调服务
文章目录
- 一、简介
- 1、概述
- 2、相关文档地址
- 二、企微配置消息服务器
- 1、配置消息接收参数
- 2、参数解析
- 3、参数拼接规则
- 三、代码编写—使用已有库
- 1、代码下载
- 2、代码修改
- 3、服务代码编写
- 四、测试
一、简介
1、概述
什么时候需要回调服务
在集成企业微信与内部系统时,我们往往需要搭建一个回调服务。回调服务,可以实现:
- 自定义丰富的服务行为。比如,用户向应用发消息时,识别消息关键词,回复不同的消息内容;用户点击应用菜单时,转化为指令,执行自动化任务。
- 可以及时获取到状态变化。比如,通讯录发生变化时,不需要定时去拉取通讯录对比,而是实时地获取到变化的通讯录结点,进行同步。
回调流程:
- 企业微信会先判断URL服务是否具备解析企业微信推送消息的能力。
具体方式是,企业微信往URL服务上发一条Get请求带签名及密文参数到URL服务上,如果URL服务检查签名通过,并能正确返回密文参数对应的明文字符串,则验证通过。此时在企业微信的配置就开始生效。 - 后续的业务请求(比如应用菜单的点击事件,用户消息等),都会类似的方式(签名+密文)向服务URL推送消息。URL服务验证签名通过后,需要将POST数据解密,就可以得到对应的业务消息明文。
企业收到消息后,需要作如下处理:
- 对msg_signature进行校验
- 解密Encrypt,得到明文的消息结构体(消息结构体后面章节会详说)
- 如果需要被动回复消息,构造被动响应包
- 正确响应本次请求
· 企业微信服务器在五秒内收不到响应会断掉连接,并且重新发起请求,总共重试三次
· 当接收成功后,http头部返回200表示接收ok,其他错误码企业微信后台会一律当做失败并发起重试
2、相关文档地址
1、回调配置
https://developer.work.weixin.qq.com/document/path/90930
2、接收消息与事件
https://developer.work.weixin.qq.com/document/10514
3、加解密方案说明
https://developer.work.weixin.qq.com/document/path/90968
4、加解密库下载与返回码
https://developer.work.weixin.qq.com/document/path/90307
二、企微配置消息服务器
1、配置消息接收参数
URL:http://8.131.239.157
Token:UPN8pOCL
EncodingAESKey:Wz0cWqM7VcqPOLpNrMCaaxMMif3USVLOjhvK19tEQaX
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-OZwjp3T2-1692458157388)(/Users/liyangda/Library/Application Support/typora-user-images/image-20230819222344569.png)]
2、参数解析
整体会用到8个参数。
参数 | 必须 | 说明 |
---|---|---|
url | URL是企业后台接收企业微信推送请求的访问协议和地址,支持http或https协议。 | |
token | Token可由企业任意填写,用于生成签名。 | |
encodingAesKey | EncodingAESKey用于消息体的加密,是AES密钥的Base64编码。 | |
receiveid | 加解密库里,ReceiveId 在各个场景的含义不同: 1. 企业应用的回调,表示corpid。 2. 第三方事件的回调,表示suiteid。 3. 个人主体的第三方应用的回调,ReceiveId是一个空字符串 | |
msg_signature | 是 | 企业微信加密签名,msg_signature结合了企业填写的token、请求中的timestamp、nonce参数、加密的消息体 |
timestamp | 是 | 时间戳 |
nonce | 是 | 随机数 |
echostr | 是 | 加密的字符串。需要解密得到消息内容明文,。 |
3、参数拼接规则
请求方式:GET
请求地址:
http://api.3dept.com/?msg_signature=ASDFQWEXZCVAQFASDFASDFSS×tamp=13500001234&nonce=123412323&echostr=ENCRYPT_STR
http://8.131.239.157?msg_signature=ed7c74fcb19645d3c8312e703063539fe96a532c×tamp=1692450209&nonce=1693051991&echostr=9fGql+XxePufd9E71gh4kXooAJJ+PtxH3MwwZWzxFNdZwTT3qccs6zHxFEDtGuaxJHWktTV97BiKkJI+rOhcPw==
三、代码编写—使用已有库
这次采用的是企微提供的已由库方式,进行验证。
1、代码下载
源代码地址:https://developer.work.weixin.qq.com/document/path/90307
2、代码修改
因为参数执行有一些问题,需要对提供的工具类进行修改。
修改内容
// 密钥,公众账号的app secret
// 提取密文
// Object[] encrypt = JsonParse.extract(postData);
Object[] encrypt = new Object[]{postData,postData};
3、服务代码编写
<dependency>
<groupId>commons-codec</groupId>
<artifactId>commons-codec</artifactId>
<version>1.9</version>
</dependency>
<dependency>
<groupId>org.json</groupId>
<artifactId>json</artifactId>
<version>20180813</version>
</dependency>
代码编写
import com.lydms.demowechat0.WechatUtils.AesException;
import com.lydms.demowechat0.WechatUtils.WXBizJsonMsgCrypt;
import lombok.extern.slf4j.Slf4j;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
@Slf4j
@RestController
public class AllTwoController {
@RequestMapping("/*")
public String getCheckInfo(String msg_signature, String timestamp, String nonce, String echostr) throws AesException {
String token = "UPN8pOCL";
String encodingAesKey = "Wz0cWqM7VcqPOLpNrMCaaxMMif3USVLOjhvK19tEQaX";
String receiveid = "ww3e40cde07cc21a01";
log.info("msg_signature:{},timestamp:{},nonce:{},echostr:{}", msg_signature, timestamp, nonce, echostr);
log.info("token:{},encodingAesKey:{},receiveid:{}", token, timestamp, receiveid);
WXBizJsonMsgCrypt wxBizJsonMsgCrypt = new WXBizJsonMsgCrypt(token, encodingAesKey, receiveid);
String str = wxBizJsonMsgCrypt.DecryptMsg(msg_signature, timestamp, nonce, echostr);
log.info("return:{}", str);
return str;
}
}
测试代码:
/**
* 测试代码
*
* @param args
* @throws AesException
*/
public static void main(String[] args) throws AesException {
// Token
String token = "UPN8pOCL";
//
String encodingAesKey = "Wz0cWqM7VcqPOLpNrMCaaxMMif3USVLOjhvK19tEQaX";
//
String receiveid = "ww3e40cde07cc21a01";
// 企业微信加密签名
String msgSignature = "359410caca920fe74a426f5a3057ad437b3b9fa4";
// 时间戳
String timeStamp = "1692448043";
// 随机数
String nonce = "1692495025";
// 加密的字符串
String echostr = "BrO11qZxqM8TBczJq17VRzSnhJff5aGXgnTvWl+yGaoAZ+dd5xg1VxbmmPzMJMmkNPv6DSlpMQ6vz4lwoCXMjg==";
WXBizJsonMsgCrypt wxBizJsonMsgCrypt = new WXBizJsonMsgCrypt(token, encodingAesKey, receiveid);
// 解析后的值:7695278663958312959
String s = wxBizJsonMsgCrypt.DecryptMsg(msgSignature, timeStamp, nonce, echostr);
System.out.println(s);
}
四、测试
将服务部署到配置的URL地址后:http://8.131.239.157
。点击保存
保存成功
查看用户消息