微信开发－回调模式

2023-11-08 16:59:10

前言

越来越多的企业借助微信平台做开发，下面记录最近开发微信项目（企业号）一些关键设置、原理及代码

一：添加应用

关注企业微信号后，点击企业号，能看到该企业号下的应用列表，它类似我们常见后台中的模块或栏目，首先我们要创建自己的应用。

二：设置应用为回调模式

创建好应用后，把应用设置成回调模式，按要求设置回调URL及密钥。保存时它会访问URL，只有URL能正确访问信息时才能保存成功，否则一直会提示失败

　　原理

以下摘自微信开发文档：

验证URL有效性

当你提交以上信息时，企业号将发送GET请求到填写的URL上，GET请求携带四个参数，企业在获取时需要做urldecode处理，否则会验证不成功。

参数	描述	是否必带
msg_signature	微信加密签名，msg_signature结合了企业填写的token、请求中的timestamp、nonce参数、加密的消息体	是
timestamp	时间戳	是
nonce	随机数	是
echostr	加密的随机字符串，以msg_encrypt格式提供。需要解密并返回echostr明文，解密后有random、msg_len、msg、$CorpID四个字段，其中msg即为echostr明文	首次校验时必带

企业通过参数msg_signature对请求进行校验，如果确认此次GET请求来自企业号，那么企业应用对echostr参数解密并原样返回echostr明文(不能加引号，不能带bom头，不能带换行符)，则接入验证生效，回调模式才能开启。

实操

为了能正确验证URL有效性，还需要以下操作

首先，我们需要一台服务器，并且有一个域名指向了该服务器，在该服务器上配置好网站。把验证URL的代码放置在该服务器上。wxpush代码如下：

package com.bf.weixin;

import java.io.IOException;
import java.io.PrintWriter;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import com.bf.meal.entity.App;
import com.qq.weixin.mp.aes.AesException;
import com.qq.weixin.mp.aes.WXBizMsgCrypt;

public class wxpush extends HttpServlet {

    public void doGet(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {

        WXBizMsgCrypt wxcpt = null;
        try {
            wxcpt = new WXBizMsgCrypt(App.getToken(), App.getEncodingAESKey(), App.getCorpID());
        } catch (AesException e1) {
            e1.printStackTrace();
        }
        
        // 解析出url上的参数值如下：
        String sVerifyMsgSig = request.getParameter("msg_signature");
        String sVerifyTimeStamp = request.getParameter("timestamp");
        String sVerifyNonce = request.getParameter("nonce"); 
        String sVerifyEchoStr = request.getParameter("echostr");
        App.logger.info("url:" + request.getQueryString());
        
        String sEchoStr; //需要返回的明文
        
        try {
            sEchoStr = wxcpt.VerifyURL(sVerifyMsgSig, sVerifyTimeStamp, sVerifyNonce, sVerifyEchoStr);
            App.logger.info("verifyurl echostr: " + sEchoStr);
            
            response.setContentType("text/html");
            PrintWriter out = response.getWriter();
            out.println(sEchoStr);
            out.flush();
            out.close();
        } catch (Exception e) {
            App.logger.error(e);
            e.printStackTrace();
        }
    }
}

View Code

注：需要到微信官网上下载

com.qq.weixin.mp.aes.AesException;

com.qq.weixin.mp.aes.WXBizMsgCrypt;

当然web.xml中还得有如下节点

  <servlet-mapping>
        <servlet-name>wxpush</servlet-name>
        <url-pattern>/servlet/wxpush</url-pattern>
    </servlet-mapping>

配置好后，应该能正确的访问URL(http://*.*.com.cn/meal/servlet/wxpush)，把该URL作为微信后台填写的值，此时应该能正确保存了。

三：获取用户帐号信息

要针对企业号关注用户做一些应用，最重要一点是要识别该用户，以便能正确区分不同的用户。

根据文档OAuth2.0验证接口说明, 建议的方案

1、企业应用中的URL链接直接填写企业自己的页面地址

2、成员跳转到企业页面时，企业校验是否有代表成员身份的cookie，此cookie由企业生成

3、如果没有获取到cookie，重定向到OAuth验证链接，获取成员身份后，由企业生成代表成员身份的cookie

4、根据cookie获取成员身份，进入相应的页面

我的做法是，配置Filter拦截所有jsp或.do文件的请求，在Filter中先去Cookie,如果Cookie不存在，则调用OAuth2.0获取信息，具体还是看关键代码

public void doFilter(ServletRequest req, ServletResponse res, FilterChain chain) throws ServletException, IOException {
        HttpServletRequest request = (HttpServletRequest) req;
        HttpServletResponse response = (HttpServletResponse) res;
        
        String userId = getUserId(request, response);
……

微信开发－回调模式

码农公寓

前言

二：设置应用为回调模式

原理

实操

三：获取用户帐号信息

相关文章

　　原理