集成企业微信接收消息API

coloful_world

已于 2022-07-27 16:13:02 修改

阅读量1.8k

点赞数

文章标签：微信 java

于 2022-07-23 14:15:23 首次发布

本文链接：https://blog.csdn.net/weixin_41632551/article/details/125947049

版权

一、文档解密库地址点击查看
进入点击下载地址
在这里插入图片描述
选择java-xml版本，相关代码导入项目。
二、解密需要下载如下2个jar包，替换本地jdk相应目录，替换完后重启电脑或服务器（文档中有下载地址）

三、GET方法无需修改，参数只需调整为HttpServletRequest获取即可。

@GetMapping("/test")
    public void test1(HttpServletRequest request, HttpServletResponse response) throws AesException {
        String sToken = "8WNe";
        String sCorpID = "ww76fd577a6eb1a49f";
        String sEncodingAESKey = "hKFU1x9CSVXAspTg3B94k211bs3e8MCvJdmiVcjCgBt";

        WXBizMsgCrypt wxcpt = new WXBizMsgCrypt(sToken, sEncodingAESKey, sCorpID);
    /*
    ------------使用示例一：验证回调URL---------------
    *企业开启回调模式时，企业微信会向验证url发送一个get请求
    假设点击验证时，企业收到类似请求：
    * GET /cgi-bin/wxpush?msg_signature=5c45ff5e21c57e6ad56bac8758b79b1d9ac89fd3&timestamp=1409659589&nonce=263014780&echostr=P9nAzCzyDtyTWESHep1vC5X9xho%2FqYX3Zpb4yKa9SKld1DsH3Iyt3tP3zNdtp%2B4RPcs8TgAE7OaBO%2BFZXvnaqQ%3D%3D
    * HTTP/1.1 Host: qy.weixin.qq.com

    接收到该请求时，企业应		1.解析出Get请求的参数，包括消息体签名(msg_signature)，时间戳(timestamp)，随机数字串(nonce)以及企业微信推送过来的随机加密字符串(echostr),
    这一步注意作URL解码。
    2.验证消息体签名的正确性
    3. 解密出echostr原文，将原文当作Get请求的response，返回给企业微信
    第2，3步可以用企业微信提供的库函数VerifyURL来实现。

    */
        // 解析出url上的参数值如下：
        String sVerifyMsgSig = request.getParameter("msg_signature");
        //String sVerifyMsgSig = "5c45ff5e21c57e6ad56bac8758b79b1d9ac89fd3";
        String sVerifyTimeStamp = request.getParameter("timestamp");
        //String sVerifyTimeStamp = "1409659589";
        String sVerifyNonce = request.getParameter("nonce");
        //String sVerifyNonce = "263014780";
        String sVerifyEchoStr = request.getParameter("echostr");
        //String sVerifyEchoStr = "P9nAzCzyDtyTWESHep1vC5X9xho/qYX3Zpb4yKa9SKld1DsH3Iyt3tP3zNdtp+4RPcs8TgAE7OaBO+FZXvnaqQ==";
        String sEchoStr; //需要返回的明文
        try {
            sEchoStr = wxcpt.VerifyURL(sVerifyMsgSig, sVerifyTimeStamp,
                    sVerifyNonce, sVerifyEchoStr);
            System.out.println("verifyurl echostr: " + sEchoStr);
            // 验证URL成功，将sEchoStr返回
            // HttpUtils.SetResponse(sEchoStr);
            response.getWriter().println(sEchoStr);
        } catch (Exception e) {
            //验证URL失败，错误原因请查看异常
            e.printStackTrace();
        }
    }

四、因原方法有些参数需要自己获得，且xml数据/n/r需要替换为空，故POST方法做如下修改

@PostMapping("/test")
    public void test2(HttpServletRequest request, HttpServletResponse response) throws IOException, AesException {
        String sToken = "应用接收数据API设置获得";
        String sCorpID = "应用获得";
        String sEncodingAESKey = "应用接收数据API设置获得";

        WXBizMsgCrypt wxcpt = new WXBizMsgCrypt(sToken, sEncodingAESKey, sCorpID);
          /*
    ------------使用示例二：对用户回复的消息解密---------------
    用户回复消息或者点击事件响应时，企业会收到回调消息，此消息是经过企业微信加密之后的密文以post形式发送给企业，密文格式请参考官方文档
    假设企业收到企业微信的回调消息如下：
    POST /cgi-bin/wxpush? msg_signature=477715d11cdb4164915debcba66cb864d751f3e6&timestamp=1409659813&nonce=1372623149 HTTP/1.1
    Host: qy.weixin.qq.com
    Content-Length: 613
    <xml>		<ToUserName><![CDATA[wx5823bf96d3bd56c7]]></ToUserName><Encrypt><![CDATA[RypEvHKD8QQKFhvQ6QleEB4J58tiPdvo+rtK1I9qca6aM/wvqnLSV5zEPeusUiX5L5X/0lWfrf0QADHHhGd3QczcdCUpj911L3vg3W/sYYvuJTs3TUUkSUXxaccAS0qhxchrRYt66wiSpGLYL42aM6A8dTT+6k4aSknmPj48kzJs8qLjvd4Xgpue06DOdnLxAUHzM6+kDZ+HMZfJYuR+LtwGc2hgf5gsijff0ekUNXZiqATP7PF5mZxZ3Izoun1s4zG4LUMnvw2r+KqCKIw+3IQH03v+BCA9nMELNqbSf6tiWSrXJB3LAVGUcallcrw8V2t9EL4EhzJWrQUax5wLVMNS0+rUPA3k22Ncx4XXZS9o0MBH27Bo6BpNelZpS+/uh9KsNlY6bHCmJU9p8g7m3fVKn28H3KDYA5Pl/T8Z1ptDAVe0lXdQ2YoyyH2uyPIGHBZZIs2pDBS8R07+qN+E7Q==]]></Encrypt>
    <AgentID><![CDATA[218]]></AgentID>
    </xml>

    企业收到post请求之后应该		1.解析出url上的参数，包括消息体签名(msg_signature)，时间戳(timestamp)以及随机数字串(nonce)
    2.验证消息体签名的正确性。
    3.将post请求的数据进行xml解析，并将<Encrypt>标签的内容进行解密，解密出来的明文即是用户回复消息的明文，明文格式请参考官方文档
    第2，3步可以用企业微信提供的库函数DecryptMsg来实现。
    */
        // String sReqMsgSig = HttpUtils.ParseUrl("msg_signature");
        String sReqMsgSig = request.getParameter("msg_signature");
        // String sReqTimeStamp = HttpUtils.ParseUrl("timestamp");
        String sReqTimeStamp = request.getParameter("timestamp");
        // String sReqNonce = HttpUtils.ParseUrl("nonce");
        String sReqNonce = request.getParameter("nonce");
        // post请求的密文数据
        // sReqData = HttpUtils.PostData();
        //String sReqData = "<xml><ToUserName><![CDATA[wx5823bf96d3bd56c7]]></ToUserName><Encrypt><![CDATA[RypEvHKD8QQKFhvQ6QleEB4J58tiPdvo+rtK1I9qca6aM/wvqnLSV5zEPeusUiX5L5X/0lWfrf0QADHHhGd3QczcdCUpj911L3vg3W/sYYvuJTs3TUUkSUXxaccAS0qhxchrRYt66wiSpGLYL42aM6A8dTT+6k4aSknmPj48kzJs8qLjvd4Xgpue06DOdnLxAUHzM6+kDZ+HMZfJYuR+LtwGc2hgf5gsijff0ekUNXZiqATP7PF5mZxZ3Izoun1s4zG4LUMnvw2r+KqCKIw+3IQH03v+BCA9nMELNqbSf6tiWSrXJB3LAVGUcallcrw8V2t9EL4EhzJWrQUax5wLVMNS0+rUPA3k22Ncx4XXZS9o0MBH27Bo6BpNelZpS+/uh9KsNlY6bHCmJU9p8g7m3fVKn28H3KDYA5Pl/T8Z1ptDAVe0lXdQ2YoyyH2uyPIGHBZZIs2pDBS8R07+qN+E7Q==]]></Encrypt><AgentID><![CDATA[218]]></AgentID></xml>";
        // 1.得到数据流
        ServletInputStream inputStream = request.getInputStream();
        String sReqData = IOUtils.toString(inputStream, "UTF-8");
        sReqData = sReqData.replaceAll("\r", "").replaceAll("\n", "").replaceAll(" ", "");

        try {
            String sMsg = wxcpt.DecryptMsg(sReqMsgSig, sReqTimeStamp, sReqNonce, sReqData);
            System.out.println("after decrypt msg: " + sMsg);
            // TODO: 解析出明文xml标签的内容进行处理
            // For example:
            DocumentBuilderFactory dbf = DocumentBuilderFactory.newInstance();
            DocumentBuilder db = dbf.newDocumentBuilder();
            StringReader sr = new StringReader(sMsg);
            InputSource is = new InputSource(sr);
            Document document = db.parse(is);

            Element root = document.getDocumentElement();
            NodeList nodelist1 = root.getElementsByTagName("Content");
            String Content = nodelist1.item(0).getTextContent();
            System.out.println("Content：" + Content);

        } catch (Exception e) {
            // TODO
            // 解密失败，失败原因请查看异常
            e.printStackTrace();
        }
    }

五、企业被动回复消息

------------使用示例三：企业回复用户消息的加密---------------
        企业被动回复用户的消息也需要进行加密，并且拼接成密文格式的xml串。
        假设企业需要回复用户的明文如下：
        <xml>
        <ToUserName><![CDATA[mycreate]]></ToUserName>
        <FromUserName><![CDATA[wx5823bf96d3bd56c7]]></FromUserName>
        <CreateTime>1348831860</CreateTime>
        <MsgType><![CDATA[text]]></MsgType>
        <Content><![CDATA[this is a test]]></Content>
        <MsgId>1234567890123456</MsgId>
        <AgentID>128</AgentID>
        </xml>

        为了将此段明文回复给用户，企业应：			1.自己生成时间时间戳(timestamp),随机数字串(nonce)以便生成消息体签名，也可以直接用从企业微信的post url上解析出的对应值。
        2.将明文加密得到密文。	3.用密文，步骤1生成的timestamp,nonce和企业在企业微信设定的token生成消息体签名。			4.将密文，消息体签名，时间戳，随机数字串拼接成xml格式的字符串，发送给企业。
        以上2，3，4步可以用企业微信提供的库函数EncryptMsg来实现。
        */
            String msg="";
            if(content.contains("aa")){
                msg = "已收到包含aa的消息，祝顺利!";
            }
            String timeMillis = System.currentTimeMillis() + "";
            String sRespData = "<xml>"
                    +"<ToUserName><![CDATA["+fromUserName+"]]></ToUserName>" //成员userid
                    +"<FromUserName><![CDATA["+sCorpID+"]]></FromUserName>"  //企业CropId
                    +"<CreateTime>"+timeMillis+"</CreateTime>"  //消息创建时间
                    +"<MsgType><![CDATA[text]]></MsgType>"  //消息类型，此时固定为：text
                    +"<Content><![CDATA["+msg+"]]></Content>"  //文本消息内容，最长为2048字节，超过将截断
                    +"<MsgId>"+msgId+"</MsgId>"
                    +"<AgentID>"+QywxUtil.aGentId+"</AgentID>"
                    +"</xml>";
            System.out.println("编辑回复数据=================>"+sRespData);
            try{
                //存放自动回复给用户的信息
                String sEncryptMsg = wxcpt.EncryptMsg(sRespData, timeMillis, sReqNonce);
                System.out.println("====================》回复的数据加密打包签名: " + sEncryptMsg);
                // 加密成功
                // TODO:
                //HttpUtils.SetResponse(sEncryptMsg);
                response.getWriter().println(sEncryptMsg);
                System.out.println("================>已执行发送");
            }
            catch(Exception e)
            {
                e.printStackTrace();
                // 加密失败
            }