java如何对接企业微信

前言

最近实现社群对接企业微信,对接的过程遇到一些点,在此记录。

企业微信介绍

企业微信具有和微信一样的体验,用于企业内部成员和外部客户的管理,可以由此构建出社群生态。
企业微信提供了丰富的api进行调用获取数据管理,也提供了各种回调事件,当数据发生变化时,可以及时知道。
我们分为两部分进行讲解,第一部分调用企业微信api,第二部分,接收企业微信的回调。

调用企业微信api

java如何对接企业微信
api的开发文档地址:https://work.weixin.qq.com/api/doc/90000/90135/90664
调用企业微信所必须的东西就是企业的accesstoken。获取accesstoken则需要我们的corpid和corpsercret。
具体我们可以参照这里https://work.weixin.qq.com/api/doc/90000/90135/91039
有了token之后,我们就可以通过http请求来调用各种api,获取数据。举一个例子,创建成员的api,如下,我们只要使用http工具调用即可。
java如何对接企业微信
这里分享一个http调用工具。
@Slf4j
public class HttpUtils {
    static CloseableHttpClient httpClient;

    private HttpUtils() {
        throw new IllegalStateException("Utility class");
    }

    static {
        Registry<connectionsocketfactory> registry = RegistryBuilder.<connectionsocketfactory>create()
                .register("http", PlainConnectionSocketFactory.getSocketFactory())
                .register("https", SSLConnectionSocketFactory.getSocketFactory())
                .build();
        PoolingHttpClientConnectionManager connectionManager = new PoolingHttpClientConnectionManager(registry);
        connectionManager.setMaxTotal(200);
        connectionManager.setDefaultMaxPerRoute(200);
        connectionManager.setDefaultSocketConfig(
                SocketConfig.custom().setSoTimeout(15, TimeUnit.SECONDS)
                        .setTcpNoDelay(true).build()
        );
        connectionManager.setValidateAfterInactivity(TimeValue.ofSeconds(15));

        httpClient = HttpClients.custom()
                .setConnectionManager(connectionManager)
                .disableAutomaticRetries()
                .build();
    }

    public static String get(String url, Map<string, object> paramMap, Map<string, string> headerMap) {
        String param = paramMap.entrySet().stream().map(n -> n.getKey() + "=" + n.getValue()).collect(Collectors.joining("&"));
        String fullUrl = url + "?" + param;
        final HttpGet httpGet = new HttpGet(fullUrl);
        if (Objects.nonNull(headerMap) && headerMap.size() > 0) {
            headerMap.forEach((key, value) -> httpGet.addHeader(key, value));
        }
        CloseableHttpResponse response = null;
        try {
            response = httpClient.execute(httpGet);
            String strResult = EntityUtils.toString(response.getEntity());
            if (200 != response.getCode()) {
                log.error("HTTP get &#x8FD4;&#x56DE;&#x72B6;&#x6001;&#x975E;200[resp={}]", strResult);
            }
            return strResult;
        } catch (IOException | ParseException e) {
            log.error("HTTP get &#x5F02;&#x5E38;", e);
            return "";
        } finally {
            if (null != response) {
                try {
                    EntityUtils.consume(response.getEntity());
                } catch (IOException e) {
                    e.printStackTrace();
                }
            }
        }
    }

    public static String post(String url,Map<string, object> paramMap, Map<string, string> headerMap, String data) {
        CloseableHttpResponse response = null;
        try {
            String param = paramMap.entrySet().stream().map(n -> n.getKey() + "=" + n.getValue()).collect(Collectors.joining("&"));
            String fullUrl = url + "?" + param;
            final HttpPost httpPost = new HttpPost(fullUrl);
            if (Objects.nonNull(headerMap) && headerMap.size() > 0) {
                headerMap.forEach((key, value) -> httpPost.addHeader(key, value));
            }
            StringEntity httpEntity = new StringEntity(data, StandardCharsets.UTF_8);
            httpPost.setEntity(httpEntity);
            response = httpClient.execute(httpPost);
            if (200 == response.getCode()) {
                String strResult = EntityUtils.toString(response.getEntity());
                return strResult;
            }
        } catch (IOException | ParseException e) {
            e.printStackTrace();
            return "";
        } finally {
            if (null != response) {
                try {
                    EntityUtils.consume(response.getEntity());
                } catch (IOException e) {
                    e.printStackTrace();
                }
            }
        }
        return "";
    }
}
</string,></string,></string,></string,></connectionsocketfactory></connectionsocketfactory>

对接企业微信的回调

回调分为很多种,比如通讯录的回调如下:
https://work.weixin.qq.com/api/doc/90000/90135/90967

整体的回调流程如下:
配置回调服务,需要有三个配置项,分别是:URL, Token, EncodingAESKey。
首先,URL为回调服务地址,由开发者搭建,用于接收通知消息或者事件。

java如何对接企业微信

其次,Token用于计算签名,由英文或数字组成且长度不超过32位的自定义字符串。开发者提供的URL是公开可访问的,这就意味着拿到这个URL,就可以往该链接推送消息。那么URL服务需要解决两个问题:

如何分辨出是否为企业微信来源
如何分辨出推送消息的内容是否被篡改
通过数字签名就可以解决上述的问题。具体为:约定Token作为密钥,仅开发者和企业微信知道,在传输中不可见,用于参与签名计算。企业微信在推送消息时,将消息内容与Token计算出签名。开发者接收到推送消息时,也按相同算法计算出签名。如果为同一签名,则可信任来源为企业微信,并且内容是完整的。

如果非企业微信来源,由于攻击者没有正确的Token,无法算出正确的签名;
如果消息内容被篡改,由于开发者会将接收的消息内容与Token重算一次签名,该值与参数的签名不一致,则会拒绝该请求。

java如何对接企业微信

最后,EncodingAESKey用于消息内容加密,由英文或数字组成且长度为43位的自定义字符串。由于消息是在公开的因特网上传输,消息内容是可被截获的,如果内容未加密,则截获者可以直接阅读消息内容。若消息内容包含一些敏感信息,就非常危险了。EncodingAESKey就是在这个背景基础上提出,将发送的内容进行加密,并组装成一定格式后再发送。

java如何对接企业微信

对接回调,我们就要实现上述的加密,篡改等代码。这里分享java版本的实现。
AesException

public class AesException extends Exception {

    public final static int OK = 0;
    public final static int ValidateSignatureError = -40001;
    public final static int ParseXmlError = -40002;
    public final static int ComputeSignatureError = -40003;
    public final static int IllegalAesKey = -40004;
    public final static int ValidateCorpidError = -40005;
    public final static int EncryptAESError = -40006;
    public final static int DecryptAESError = -40007;
    public final static int IllegalBuffer = -40008;

    private int code;

    private static String getMessage(int code) {
        switch (code) {
            case ValidateSignatureError:
                return "&#x7B7E;&#x540D;&#x9A8C;&#x8BC1;&#x9519;&#x8BEF;";
            case ParseXmlError:
                return "xml&#x89E3;&#x6790;&#x5931;&#x8D25;";
            case ComputeSignatureError:
                return "sha&#x52A0;&#x5BC6;&#x751F;&#x6210;&#x7B7E;&#x540D;&#x5931;&#x8D25;";
            case IllegalAesKey:
                return "SymmetricKey&#x975E;&#x6CD5;";
            case ValidateCorpidError:
                return "corpid&#x6821;&#x9A8C;&#x5931;&#x8D25;";
            case EncryptAESError:
                return "aes&#x52A0;&#x5BC6;&#x5931;&#x8D25;";
            case DecryptAESError:
                return "aes&#x89E3;&#x5BC6;&#x5931;&#x8D25;";
            case IllegalBuffer:
                return "&#x89E3;&#x5BC6;&#x540E;&#x5F97;&#x5230;&#x7684;buffer&#x975E;&#x6CD5;";
            default:
                return null;
        }
    }

    public int getCode() {
        return code;
    }

    AesException(int code) {
        super(getMessage(code));
        this.code = code;
    }

}

MessageUtil

public class MessageUtil {

    /**
     * &#x89E3;&#x6790;&#x5FAE;&#x4FE1;&#x53D1;&#x6765;&#x7684;&#x8BF7;&#x6C42;&#xFF08;XML&#xFF09;.

     *
     * @param msg &#x6D88;&#x606F;
     * @return map
     */
    public static Map<string, string> parseXml(final String msg) {
        // &#x5C06;&#x89E3;&#x6790;&#x7ED3;&#x679C;&#x5B58;&#x50A8;&#x5728;HashMap&#x4E2D;
        Map<string, string> map = new HashMap<string, string>();

        // &#x4ECE;request&#x4E2D;&#x53D6;&#x5F97;&#x8F93;&#x5165;&#x6D41;
        try (InputStream inputStream = new ByteArrayInputStream(msg.getBytes(StandardCharsets.UTF_8.name()))) {
            // &#x8BFB;&#x53D6;&#x8F93;&#x5165;&#x6D41;
            SAXReader reader = new SAXReader();
            Document document = reader.read(inputStream);
            // &#x5F97;&#x5230;xml&#x6839;&#x5143;&#x7D20;
            Element root = document.getRootElement();
            // &#x5F97;&#x5230;&#x6839;&#x5143;&#x7D20;&#x7684;&#x6240;&#x6709;&#x5B50;&#x8282;&#x70B9;
            List<element> elementList = root.elements();

            // &#x904D;&#x5386;&#x6240;&#x6709;&#x5B50;&#x8282;&#x70B9;
            for (Element e : elementList) {
                map.put(e.getName(), e.getText());
            }
        } catch (Exception e) {
            e.printStackTrace();
        }

        return map;
    }

}
</element></string,></string,></string,>
public enum QywechatEnum {

    TEST("&#x6D4B;&#x8BD5;", "123123123123", "123123123123", "12312312312");

    /**
     * &#x5E94;&#x7528;&#x540D;
     */
    private String name;

    /**
     * &#x4F01;&#x4E1A;ID
     */
    private String corpid;

    /**
     * &#x56DE;&#x8C03;url&#x914D;&#x7F6E;&#x7684;token
     */
    private String token;

    /**
     * &#x968F;&#x673A;&#x52A0;&#x5BC6;&#x4E32;
     */
    private String encodingAESKey;

    QywechatEnum(final String name, final String corpid, final String token, final String encodingAESKey) {
        this.name = name;
        this.corpid = corpid;
        this.encodingAESKey = encodingAESKey;
        this.token = token;
    }

    public String getCorpid() {
        return corpid;
    }

    public String getName() {
        return name;
    }

    public String getToken() {
        return token;
    }

    public String getEncodingAESKey() {
        return encodingAESKey;
    }

}
public class QywechatInfo {

    /**
     * &#x7B7E;&#x540D;
     */
    private String msgSignature;

    /**
     * &#x968F;&#x673A;&#x65F6;&#x95F4;&#x6233;
     */
    private String timestamp;

    /**
     * &#x968F;&#x673A;&#x503C;
     */
    private String nonce;

    /**
     * &#x52A0;&#x5BC6;&#x7684;xml&#x5B57;&#x7B26;&#x4E32;
     */
    private String sPostData;

    /**
     * &#x4F01;&#x4E1A;&#x5FAE;&#x4FE1;&#x56DE;&#x8C03;&#x914D;&#x7F6E;
     */
    private QywechatEnum qywechatEnum;

}
public class SHA1Utils {

    /**
     * &#x7528;SHA1&#x7B97;&#x6CD5;&#x751F;&#x6210;&#x5B89;&#x5168;&#x7B7E;&#x540D;
     *
     * @param token     &#x7968;&#x636E;
     * @param timestamp &#x65F6;&#x95F4;&#x6233;
     * @param nonce     &#x968F;&#x673A;&#x5B57;&#x7B26;&#x4E32;
     * @param encrypt   &#x5BC6;&#x6587;
     * @return &#x5B89;&#x5168;&#x7B7E;&#x540D;
     * @throws AesException
     */
    public static String getSHA1(String token, String timestamp, String nonce, String encrypt) throws AesException {
        try {
            String[] array = new String[]{token, timestamp, nonce, encrypt};
            StringBuffer sb = new StringBuffer();
            // &#x5B57;&#x7B26;&#x4E32;&#x6392;&#x5E8F;
            Arrays.sort(array);
            for (int i = 0; i < 4; i++) {
                sb.append(array[i]);
            }
            String str = sb.toString();
            // SHA1&#x7B7E;&#x540D;&#x751F;&#x6210;
            MessageDigest md = MessageDigest.getInstance("SHA-1");
            md.update(str.getBytes());
            byte[] digest = md.digest();
            StringBuffer hexstr = new StringBuffer();
            String shaHex = "";
            for (int i = 0; i < digest.length; i++) {
                shaHex = Integer.toHexString(digest[i] & 0xFF);
                if (shaHex.length() < 2) {
                    hexstr.append(0);
                }
                hexstr.append(shaHex);
            }
            return hexstr.toString();
        } catch (Exception e) {
            e.printStackTrace();
            throw new AesException(AesException.ComputeSignatureError);
        }
    }

}
public class WXBizMsgCrypt {
    static Charset CHARSET = Charset.forName("utf-8");
    Base64 base64 = new Base64();
    byte[] aesKey;
    String token;
    String receiveid;

    /**
     * &#x6784;&#x9020;&#x51FD;&#x6570;
     *
     * @throws AesException &#x6267;&#x884C;&#x5931;&#x8D25;&#xFF0C;&#x8BF7;&#x67E5;&#x770B;&#x8BE5;&#x5F02;&#x5E38;&#x7684;&#x9519;&#x8BEF;&#x7801;&#x548C;&#x5177;&#x4F53;&#x7684;&#x9519;&#x8BEF;&#x4FE1;&#x606F;
     */
    public WXBizMsgCrypt(final QywechatEnum qywechatEnum) throws AesException {
        this.token = qywechatEnum.getToken();
        this.receiveid = qywechatEnum.getCorpid();
        String encodingAesKey = qywechatEnum.getEncodingAESKey();
        if (encodingAesKey.length() != 43) {
            throw new AesException(AesException.IllegalAesKey);
        }
        aesKey = Base64.decodeBase64(encodingAesKey + "=");

    }

    // &#x751F;&#x6210;4&#x4E2A;&#x5B57;&#x8282;&#x7684;&#x7F51;&#x7EDC;&#x5B57;&#x8282;&#x5E8F;
    byte[] getNetworkBytesOrder(int sourceNumber) {
        byte[] orderBytes = new byte[4];
        orderBytes[3] = (byte) (sourceNumber & 0xFF);
        orderBytes[2] = (byte) (sourceNumber >> 8 & 0xFF);
        orderBytes[1] = (byte) (sourceNumber >> 16 & 0xFF);
        orderBytes[0] = (byte) (sourceNumber >> 24 & 0xFF);
        return orderBytes;
    }

    // &#x8FD8;&#x539F;4&#x4E2A;&#x5B57;&#x8282;&#x7684;&#x7F51;&#x7EDC;&#x5B57;&#x8282;&#x5E8F;
    int recoverNetworkBytesOrder(byte[] orderBytes) {
        int sourceNumber = 0;
        for (int i = 0; i < 4; i++) {
            sourceNumber <<= 20 8; sourcenumber |="orderBytes[i]" & 0xff; } return sourcenumber; 随机生成16位字符串 string getrandomstr() { base="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789" ; random random(); stringbuffer sb="new" stringbuffer(); for (int i="0;" < 16; i++) int number="random.nextInt(base.length());" sb.append(base.charat(number)); sb.tostring(); ** * 对明文进行加密. @param text 需要加密的明文 @return 加密后base64编码的字符串 @throws aesexception aes加密失败 encrypt(string randomstr, text) throws bytegroup bytecollector="new" bytegroup(); byte[] randomstrbytes="randomStr.getBytes(CHARSET);" textbytes="text.getBytes(CHARSET);" networkbytesorder="getNetworkBytesOrder(textBytes.length);" receiveidbytes="receiveid.getBytes(CHARSET);" randomstr + receiveid bytecollector.addbytes(randomstrbytes); bytecollector.addbytes(networkbytesorder); bytecollector.addbytes(textbytes); bytecollector.addbytes(receiveidbytes); ... pad: 使用自定义的填充方式对明文进行补位填充 padbytes="PKCS7Encoder.encode(byteCollector.size());" bytecollector.addbytes(padbytes); 获得最终的字节流, 未加密 unencrypted="byteCollector.toBytes();" try 设置加密模式为aes的cbc模式 cipher secretkeyspec keyspec="new" secretkeyspec(aeskey, "aes"); ivparameterspec iv="new" ivparameterspec(aeskey, 0, 16); cipher.init(cipher.encrypt_mode, keyspec, iv); 加密 encrypted="cipher.doFinal(unencrypted);" 使用base64对加密后的字符串进行编码 base64encrypted="base64.encodeToString(encrypted);" base64encrypted; catch (exception e) e.printstacktrace(); throw new aesexception(aesexception.encryptaeserror); 对密文进行解密. 需要解密的密文 解密得到的明文 aes解密失败 decrypt(string original; 设置解密模式为aes的cbc模式 key_spec="new" ivparameterspec(arrays.copyofrange(aeskey, 16)); cipher.init(cipher.decrypt_mode, key_spec, 使用base64对密文进行解码 解密 original="cipher.doFinal(encrypted);" aesexception(aesexception.decryptaeserror); xmlcontent, from_receiveid; 去除补位字符 bytes="PKCS7Encoder.decode(original);" 分离16位随机字符串,网络字节序和receiveid networkorder="Arrays.copyOfRange(bytes," 16, 20); xmllength="recoverNetworkBytesOrder(networkOrder);" xmlcontent="new" string(arrays.copyofrange(bytes, 20, xmllength), charset); from_receiveid="new" xmllength, bytes.length), aesexception(aesexception.illegalbuffer); receiveid不相同的情况 if (!from_receiveid.equals(receiveid)) aesexception(aesexception.validatecorpiderror); xmlcontent; 将企业微信回复用户的消息加密打包. <ol>
     *  <li>&#x5BF9;&#x8981;&#x53D1;&#x9001;&#x7684;&#x6D88;&#x606F;&#x8FDB;&#x884C;AES-CBC&#x52A0;&#x5BC6;</li>
     *  <li>&#x751F;&#x6210;&#x5B89;&#x5168;&#x7B7E;&#x540D;</li>
     *  <li>&#x5C06;&#x6D88;&#x606F;&#x5BC6;&#x6587;&#x548C;&#x5B89;&#x5168;&#x7B7E;&#x540D;&#x6253;&#x5305;&#x6210;xml&#x683C;&#x5F0F;</li>
     *
     *
     * @param replyMsg &#x4F01;&#x4E1A;&#x5FAE;&#x4FE1;&#x5F85;&#x56DE;&#x590D;&#x7528;&#x6237;&#x7684;&#x6D88;&#x606F;&#xFF0C;xml&#x683C;&#x5F0F;&#x7684;&#x5B57;&#x7B26;&#x4E32;
     * @param timeStamp &#x65F6;&#x95F4;&#x6233;&#xFF0C;&#x53EF;&#x4EE5;&#x81EA;&#x5DF1;&#x751F;&#x6210;&#xFF0C;&#x4E5F;&#x53EF;&#x4EE5;&#x7528;URL&#x53C2;&#x6570;&#x7684;timestamp
     * @param nonce &#x968F;&#x673A;&#x4E32;&#xFF0C;&#x53EF;&#x4EE5;&#x81EA;&#x5DF1;&#x751F;&#x6210;&#xFF0C;&#x4E5F;&#x53EF;&#x4EE5;&#x7528;URL&#x53C2;&#x6570;&#x7684;nonce
     *
     * @return &#x52A0;&#x5BC6;&#x540E;&#x7684;&#x53EF;&#x4EE5;&#x76F4;&#x63A5;&#x56DE;&#x590D;&#x7528;&#x6237;&#x7684;&#x5BC6;&#x6587;&#xFF0C;&#x5305;&#x62EC;msg_signature, timestamp, nonce, encrypt&#x7684;xml&#x683C;&#x5F0F;&#x7684;&#x5B57;&#x7B26;&#x4E32;
     * @throws AesException &#x6267;&#x884C;&#x5931;&#x8D25;&#xFF0C;&#x8BF7;&#x67E5;&#x770B;&#x8BE5;&#x5F02;&#x5E38;&#x7684;&#x9519;&#x8BEF;&#x7801;&#x548C;&#x5177;&#x4F53;&#x7684;&#x9519;&#x8BEF;&#x4FE1;&#x606F;
     */
    public String EncryptMsg(String replyMsg, String timeStamp, String nonce) throws AesException {
        // &#x52A0;&#x5BC6;
        String encrypt = encrypt(getRandomStr(), replyMsg);

        // &#x751F;&#x6210;&#x5B89;&#x5168;&#x7B7E;&#x540D;
        if (timeStamp == "") {
            timeStamp = Long.toString(System.currentTimeMillis());
        }

        String signature = SHA1Utils.getSHA1(token, timeStamp, nonce, encrypt);

        // System.out.println("&#x53D1;&#x9001;&#x7ED9;&#x5E73;&#x53F0;&#x7684;&#x7B7E;&#x540D;&#x662F;: " + signature[1].toString());
        // &#x751F;&#x6210;&#x53D1;&#x9001;&#x7684;xml
        String result = XMLParse.generate(encrypt, signature, timeStamp, nonce);
        return result;
    }

    /**
     * &#x68C0;&#x9A8C;&#x6D88;&#x606F;&#x7684;&#x771F;&#x5B9E;&#x6027;&#xFF0C;&#x5E76;&#x4E14;&#x83B7;&#x53D6;&#x89E3;&#x5BC6;&#x540E;&#x7684;&#x660E;&#x6587;.

     * <ol>
     *  <li>&#x5229;&#x7528;&#x6536;&#x5230;&#x7684;&#x5BC6;&#x6587;&#x751F;&#x6210;&#x5B89;&#x5168;&#x7B7E;&#x540D;&#xFF0C;&#x8FDB;&#x884C;&#x7B7E;&#x540D;&#x9A8C;&#x8BC1;</li>
     *  <li>&#x82E5;&#x9A8C;&#x8BC1;&#x901A;&#x8FC7;&#xFF0C;&#x5219;&#x63D0;&#x53D6;xml&#x4E2D;&#x7684;&#x52A0;&#x5BC6;&#x6D88;&#x606F;</li>
     *  <li>&#x5BF9;&#x6D88;&#x606F;&#x8FDB;&#x884C;&#x89E3;&#x5BC6;</li>
     * </ol>
     *
     * @param qywechatInfo  bean
     * @return &#x89E3;&#x5BC6;&#x540E;&#x7684;&#x539F;&#x6587;
     * @throws AesException &#x6267;&#x884C;&#x5931;&#x8D25;&#xFF0C;&#x8BF7;&#x67E5;&#x770B;&#x8BE5;&#x5F02;&#x5E38;&#x7684;&#x9519;&#x8BEF;&#x7801;&#x548C;&#x5177;&#x4F53;&#x7684;&#x9519;&#x8BEF;&#x4FE1;&#x606F;
     */
    public String decryptMsg(final QywechatInfo qywechatInfo)
            throws AesException {

        // &#x5BC6;&#x94A5;&#xFF0C;&#x516C;&#x4F17;&#x8D26;&#x53F7;&#x7684;app secret
        // &#x63D0;&#x53D6;&#x5BC6;&#x6587;
        Object[] encrypt = XMLParse.extract(qywechatInfo.getSPostData());
        /**
         * @param msgSignature &#x7B7E;&#x540D;&#x4E32;&#xFF0C;&#x5BF9;&#x5E94;URL&#x53C2;&#x6570;&#x7684;msg_signature
         * @param timeStamp &#x65F6;&#x95F4;&#x6233;&#xFF0C;&#x5BF9;&#x5E94;URL&#x53C2;&#x6570;&#x7684;timestamp
         * @param nonce &#x968F;&#x673A;&#x4E32;&#xFF0C;&#x5BF9;&#x5E94;URL&#x53C2;&#x6570;&#x7684;nonce
         * @param postData &#x5BC6;&#x6587;&#xFF0C;&#x5BF9;&#x5E94;POST&#x8BF7;&#x6C42;&#x7684;&#x6570;&#x636E;
         */
        // &#x9A8C;&#x8BC1;&#x5B89;&#x5168;&#x7B7E;&#x540D;
        String signature = SHA1Utils.getSHA1(token, qywechatInfo.getTimestamp(), qywechatInfo.getNonce(), encrypt[1].toString());

        // &#x548C;URL&#x4E2D;&#x7684;&#x7B7E;&#x540D;&#x6BD4;&#x8F83;&#x662F;&#x5426;&#x76F8;&#x7B49;
        // System.out.println("&#x7B2C;&#x4E09;&#x65B9;&#x6536;&#x5230;URL&#x4E2D;&#x7684;&#x7B7E;&#x540D;&#xFF1A;" + msg_sign);
        // System.out.println("&#x7B2C;&#x4E09;&#x65B9;&#x6821;&#x9A8C;&#x7B7E;&#x540D;&#xFF1A;" + signature);
        if (!signature.equals(qywechatInfo.getMsgSignature())) {
            throw new AesException(AesException.ValidateSignatureError);
        }

        // &#x89E3;&#x5BC6;
        String result = decrypt(encrypt[1].toString());
        return result;
    }

    /**
     * &#x9A8C;&#x8BC1;URL
     * @param msgSignature &#x7B7E;&#x540D;&#x4E32;&#xFF0C;&#x5BF9;&#x5E94;URL&#x53C2;&#x6570;&#x7684;msg_signature
     * @param timeStamp &#x65F6;&#x95F4;&#x6233;&#xFF0C;&#x5BF9;&#x5E94;URL&#x53C2;&#x6570;&#x7684;timestamp
     * @param nonce &#x968F;&#x673A;&#x4E32;&#xFF0C;&#x5BF9;&#x5E94;URL&#x53C2;&#x6570;&#x7684;nonce
     * @param echoStr &#x968F;&#x673A;&#x4E32;&#xFF0C;&#x5BF9;&#x5E94;URL&#x53C2;&#x6570;&#x7684;echostr
     *
     * @return &#x89E3;&#x5BC6;&#x4E4B;&#x540E;&#x7684;echostr
     * @throws AesException &#x6267;&#x884C;&#x5931;&#x8D25;&#xFF0C;&#x8BF7;&#x67E5;&#x770B;&#x8BE5;&#x5F02;&#x5E38;&#x7684;&#x9519;&#x8BEF;&#x7801;&#x548C;&#x5177;&#x4F53;&#x7684;&#x9519;&#x8BEF;&#x4FE1;&#x606F;
     */
    public String verifyURL(String msgSignature, String timeStamp, String nonce, String echoStr)
            throws AesException {
        String signature = SHA1Utils.getSHA1(token, timeStamp, nonce, echoStr);

        if (!signature.equals(msgSignature)) {
            throw new AesException(AesException.ValidateSignatureError);
        }

        String result = decrypt(echoStr);
        return result;
    }

    static class ByteGroup {
        ArrayList<byte> byteContainer = new ArrayList<byte>();

        public byte[] toBytes() {
            byte[] bytes = new byte[byteContainer.size()];
            for (int i = 0; i < byteContainer.size(); i++) {
                bytes[i] = byteContainer.get(i);
            }
            return bytes;
        }

        public ByteGroup addBytes(byte[] bytes) {
            for (byte b : bytes) {
                byteContainer.add(b);
            }
            return this;
        }

        public int size() {
            return byteContainer.size();
        }
    }

    static class PKCS7Encoder {
        static Charset CHARSET = Charset.forName("utf-8");
        static int BLOCK_SIZE = 32;

        /**
         * &#x83B7;&#x5F97;&#x5BF9;&#x660E;&#x6587;&#x8FDB;&#x884C;&#x8865;&#x4F4D;&#x586B;&#x5145;&#x7684;&#x5B57;&#x8282;.

         *
         * @param count &#x9700;&#x8981;&#x8FDB;&#x884C;&#x586B;&#x5145;&#x8865;&#x4F4D;&#x64CD;&#x4F5C;&#x7684;&#x660E;&#x6587;&#x5B57;&#x8282;&#x4E2A;&#x6570;
         * @return &#x8865;&#x9F50;&#x7528;&#x7684;&#x5B57;&#x8282;&#x6570;&#x7EC4;
         */
        static byte[] encode(int count) {
            // &#x8BA1;&#x7B97;&#x9700;&#x8981;&#x586B;&#x5145;&#x7684;&#x4F4D;&#x6570;
            int amountToPad = BLOCK_SIZE - (count % BLOCK_SIZE);
            if (amountToPad == 0) {
                amountToPad = BLOCK_SIZE;
            }
            // &#x83B7;&#x5F97;&#x8865;&#x4F4D;&#x6240;&#x7528;&#x7684;&#x5B57;&#x7B26;
            char padChr = chr(amountToPad);
            String tmp = new String();
            for (int index = 0; index < amountToPad; index++) {
                tmp += padChr;
            }
            return tmp.getBytes(CHARSET);
        }

        /**
         * &#x5220;&#x9664;&#x89E3;&#x5BC6;&#x540E;&#x660E;&#x6587;&#x7684;&#x8865;&#x4F4D;&#x5B57;&#x7B26;
         *
         * @param decrypted &#x89E3;&#x5BC6;&#x540E;&#x7684;&#x660E;&#x6587;
         * @return &#x5220;&#x9664;&#x8865;&#x4F4D;&#x5B57;&#x7B26;&#x540E;&#x7684;&#x660E;&#x6587;
         */
        static byte[] decode(byte[] decrypted) {
            int pad = (int) decrypted[decrypted.length - 1];
            if (pad < 1 || pad > 32) {
                pad = 0;
            }
            return Arrays.copyOfRange(decrypted, 0, decrypted.length - pad);
        }

        /**
         * &#x5C06;&#x6570;&#x5B57;&#x8F6C;&#x5316;&#x6210;ASCII&#x7801;&#x5BF9;&#x5E94;&#x7684;&#x5B57;&#x7B26;&#xFF0C;&#x7528;&#x4E8E;&#x5BF9;&#x660E;&#x6587;&#x8FDB;&#x884C;&#x8865;&#x7801;
         *
         * @param a &#x9700;&#x8981;&#x8F6C;&#x5316;&#x7684;&#x6570;&#x5B57;
         * @return &#x8F6C;&#x5316;&#x5F97;&#x5230;&#x7684;&#x5B57;&#x7B26;
         */
        static char chr(int a) {
            byte target = (byte) (a & 0xFF);
            return (char) target;
        }

    }

}
</byte></byte></=>
public class XMLParse {

    /**
     * &#x63D0;&#x53D6;&#x51FA;xml&#x6570;&#x636E;&#x5305;&#x4E2D;&#x7684;&#x52A0;&#x5BC6;&#x6D88;&#x606F;
     *
     * @param xmltext &#x5F85;&#x63D0;&#x53D6;&#x7684;xml&#x5B57;&#x7B26;&#x4E32;
     * @return &#x63D0;&#x53D6;&#x51FA;&#x7684;&#x52A0;&#x5BC6;&#x6D88;&#x606F;&#x5B57;&#x7B26;&#x4E32;
     * @throws AesException
     */
    public static Object[] extract(String xmltext) throws AesException {
        Object[] result = new Object[3];
        try {
            DocumentBuilderFactory dbf = DocumentBuilderFactory.newInstance();

            String FEATURE = null;
            // This is the PRIMARY defense. If DTDs (doctypes) are disallowed, almost all XML entity attacks are prevented
            // Xerces 2 only - http://xerces.apache.org/xerces2-j/features.html#disallow-doctype-decl
            FEATURE = "http://apache.org/xml/features/disallow-doctype-decl";
            dbf.setFeature(FEATURE, true);

            // If you can't completely disable DTDs, then at least do the following:
            // Xerces 1 - http://xerces.apache.org/xerces-j/features.html#external-general-entities
            // Xerces 2 - http://xerces.apache.org/xerces2-j/features.html#external-general-entities
            // JDK7+ - http://xml.org/sax/features/external-general-entities
            FEATURE = "http://xml.org/sax/features/external-general-entities";
            dbf.setFeature(FEATURE, false);

            // Xerces 1 - http://xerces.apache.org/xerces-j/features.html#external-parameter-entities
            // Xerces 2 - http://xerces.apache.org/xerces2-j/features.html#external-parameter-entities
            // JDK7+ - http://xml.org/sax/features/external-parameter-entities
            FEATURE = "http://xml.org/sax/features/external-parameter-entities";
            dbf.setFeature(FEATURE, false);

            // Disable external DTDs as well
            FEATURE = "http://apache.org/xml/features/nonvalidating/load-external-dtd";
            dbf.setFeature(FEATURE, false);

            // and these as well, per Timothy Morgan's 2014 paper: "XML Schema, DTD, and Entity Attacks"
            dbf.setXIncludeAware(false);
            dbf.setExpandEntityReferences(false);

            // And, per Timothy Morgan: "If for some reason support for inline DOCTYPEs are a requirement, then
            // ensure the entity settings are disabled (as shown above) and beware that SSRF attacks
            // (http://cwe.mitre.org/data/definitions/918.html) and denial
            // of service attacks (such as billion laughs or decompression bombs via "jar:") are a risk."

            // remaining parser logic
            DocumentBuilder db = dbf.newDocumentBuilder();
            StringReader sr = new StringReader(xmltext);
            InputSource is = new InputSource(sr);
            Document document = db.parse(is);

            Element root = document.getDocumentElement();
            NodeList nodelist1 = root.getElementsByTagName("Encrypt");
            NodeList nodelist2 = root.getElementsByTagName("ToUserName");
            result[0] = 0;
            result[1] = nodelist1.item(0).getTextContent();
            result[2] = nodelist2.item(0).getTextContent();
            return result;
        } catch (Exception e) {
            e.printStackTrace();
            throw new AesException(AesException.ParseXmlError);
        }
    }

    /**
     * &#x751F;&#x6210;xml&#x6D88;&#x606F;
     *
     * @param encrypt   &#x52A0;&#x5BC6;&#x540E;&#x7684;&#x6D88;&#x606F;&#x5BC6;&#x6587;
     * @param signature &#x5B89;&#x5168;&#x7B7E;&#x540D;
     * @param timestamp &#x65F6;&#x95F4;&#x6233;
     * @param nonce     &#x968F;&#x673A;&#x5B57;&#x7B26;&#x4E32;
     * @return &#x751F;&#x6210;&#x7684;xml&#x5B57;&#x7B26;&#x4E32;
     */
    public static String generate(String encrypt, String signature, String timestamp, String nonce) {

        String format = "<xml>\n" + "<encrypt><!--[CDATA[%1$s]]--></encrypt>\n"
                + "<msgsignature><!--[CDATA[%2$s]]--></msgsignature>\n"
                + "<timestamp>%3$s</timestamp>\n" + "<nonce><!--[CDATA[%4$s]]--></nonce>\n" + "</xml>";
        return String.format(format, encrypt, signature, timestamp, nonce);

    }
}
public class CallbackController {

    @Resource
    private CallbackProducer callbackProducer;

    /**
     * get&#x8BF7;&#x6C42;&#x7528;&#x4E8E;&#x9A8C;&#x7B7E;
     */
    @GetMapping(value = "/callback")
    public void receiveMsg(@RequestParam(name = "msg_signature") final String msgSignature,
                           @RequestParam(name = "timestamp") final String timestamp,
                           @RequestParam(name = "nonce") final String nonce,
                           @RequestParam(name = "echostr") final String echostr,
                           final HttpServletResponse response) throws Exception {
        QywechatEnum qywechatEnum = QywechatEnum.JXPP;
        log.info("get&#x9A8C;&#x7B7E;&#x8BF7;&#x6C42;&#x53C2;&#x6570; msg_signature {}, timestamp {}, nonce {} , echostr {}", msgSignature, timestamp, nonce, echostr);
        WXBizMsgCrypt wxBizMsgCrypt = new WXBizMsgCrypt(qywechatEnum);
        String sEchoStr = wxBizMsgCrypt.verifyURL(msgSignature, timestamp, nonce, echostr);
        PrintWriter out = response.getWriter();
        try {
            //&#x5FC5;&#x987B;&#x8981;&#x8FD4;&#x56DE;&#x89E3;&#x5BC6;&#x4E4B;&#x540E;&#x7684;&#x660E;&#x6587;
            if (StringUtils.isBlank(sEchoStr)) {
                log.info("get&#x9A8C;&#x7B7E;URL&#x9A8C;&#x8BC1;&#x5931;&#x8D25;");
            } else {
                log.info("get&#x9A8C;&#x7B7E;&#x9A8C;&#x8BC1;&#x6210;&#x529F;!");
            }
        } catch (Exception e) {
            log.error("get&#x9A8C;&#x7B7E;&#x62A5;&#x9519;&#xFF01;", e);
        }
        log.info("get&#x9A8C;&#x7B7E;&#x7684;echo&#x662F;{}", sEchoStr);
        out.write(sEchoStr);
        out.flush();
    }

    /**
     * &#x4F01;&#x4E1A;&#x5FAE;&#x4FE1;&#x5BA2;&#x6237;&#x8054;&#x7CFB;&#x56DE;&#x8C03;
     */
    @ResponseBody
    @PostMapping(value = "/callback")
    public String acceptMessage(final HttpServletRequest request,
                                @RequestParam(name = "msg_signature") final String sMsgSignature,
                                @RequestParam(name = "timestamp") final String sTimestamp,
                                @RequestParam(name = "nonce") final String sNonce) {
        QywechatEnum qywechatEnum = QywechatEnum.TEST;
        try {
            InputStream inputStream = request.getInputStream();
            String sPostData = IOUtils.toString(inputStream, "UTF-8");
            QywechatInfo qywechatInfo = new QywechatInfo();
            qywechatInfo.setMsgSignature(sMsgSignature);
            qywechatInfo.setNonce(sNonce);
            qywechatInfo.setQywechatEnum(qywechatEnum);
            qywechatInfo.setTimestamp(sTimestamp);
            qywechatInfo.setSPostData(sPostData);
            WXBizMsgCrypt msgCrypt = new WXBizMsgCrypt(qywechatInfo.getQywechatEnum());
            String sMsg = msgCrypt.decryptMsg(qywechatInfo);
            Map<string, string> dataMap = MessageUtil.parseXml(sMsg);
            log.info("&#x56DE;&#x8C03;&#x7684;xml&#x6570;&#x636E;&#x8F6C;&#x4E3A;map&#x7684;&#x6570;&#x636E;{}", JsonHelper.toJSONString(dataMap));
        } catch (Exception e) {
            log.info("&#x56DE;&#x8C03;&#x62A5;&#x9519;", e);
        }
        return "success";
    }

}
</string,>

如上代码拷贝好后,我们便可以在企业微信的回调事件配置界面,增加回调的连接地址。

java如何对接企业微信

实现方案过程中遇到的点

1、回调配置的地址只支持一个,所以要把回调服务抽取出来,申请公网域名。要注意将接收到的回调消息放到消息队列,供其他所有服务接收处理。
2、处理回调要注意逆序问题,假如更新操作先来了,新增操作还没有开始。
3、可以采用消息补偿,定时任务刷新机制,手动同步机制,保证数据的一致性。
4、要实现重试机制,因为可能触发微信的并发调用限制。

Original: https://www.cnblogs.com/jichi/p/15780681.html
Author: 经典鸡翅
Title: java如何对接企业微信

原创文章受到原创版权保护。转载请注明出处:https://www.johngo689.com/538353/

转载文章受原作者版权保护。转载请注明原作者出处!

(0)

大家都在看

  • 从零开始实现放置游戏(六)——实现后台管理系统(4)Excel批量导入

    前面我们已经实现了在后台管理系统中,对配置数据的增删查改。但每次添加只能添加一条数据,实际生产中,大量数据通过手工一条一条添加不太现实。本章我们就实现通过Excel导入配置数据的功…

    Java 2023年6月5日
    0105
  • 程序员你如何检查参数的合法性?

    作为程序员的你,代码中最多的就是各种方法了,你是如何对参数进行校验的呢? 背景 大部分的方法和构造函数对传入的参数值有一些限制,比如:常见的索引值必须是非负数,对象引用不能为空。 …

    Java 2023年6月8日
    091
  • Java是一门强类型语言

    数据类型 语言类型 强类型语言 要求变量的使用要严格符合规定,所有变量都必须先定义后才能使用 弱类型语言 java的数据类型 1 基本类型(primitive type)2 引用类…

    Java 2023年6月9日
    078
  • 通俗易懂的了解String中的intern方法

    首先,先看一下intern 方法(JDK1.8 )的官方文档: 全是英文,阅读起来有点困难怎么办?没关系,博主对此做了翻译: 返回字符串对象的规范表示形式。 最初为空的字符串池由类…

    Java 2023年6月16日
    073
  • (Java初学篇)IDEA项目新建流程和软件配置优化以及怎么彻底删除项目

    相信很多小伙伴们在初学 Java 时都会出现这样的情况,就是在网上一顿搜索加捣鼓终于把 JDK 和IDEA 这两款软件安装配置好,但是发现面对这个陌生的软件此时却无从下手,那么接下…

    Java 2023年6月15日
    0134
  • android游戏妄撮java源码

    采用css+js实现 ==代码说明 index.html 程序加载运行的第一个页面,也是整个程序的入口 其它.html页面 程序中其它不同页面的内容信息界面 icon.png 用于…

    Java 2023年5月29日
    063
  • SpringBoot整合SpringCloud

    1、先创建一个空工程,然后创建注册中心模块(Eureka)、服务消费者和服务提供者 ​ 注册中心 服务消费者 服务提供者 2、注册中心配置 在application.yml配置 s…

    Java 2023年6月7日
    069
  • javascript: get Operating System version

    javascript: javascript;gutter:true; console.log(navigator.userAgent) console.log(navigator…

    Java 2023年6月16日
    069
  • ntpdate[31915]: the NTP socket is in use, exiting

    cron 作业中运行 ntpdate,以便大约每隔一小时就设置一次本地时间。最近,我每次运行该命令时都会收到下列错误消息。 ntpdate[31915]: the NTP sock…

    Java 2023年6月16日
    058
  • SpringSecurity之Oauth2介绍

    Oauth2认证的简单介绍 简介 第三方认证技术方案最主要是解决 认证协议的通用标准问题,因为要实现跨系统认证,各系统之间要遵循一定的接口协议。 OAUTH协议为用户资源的授权提供…

    Java 2023年6月5日
    0127
  • LEDE 虚拟机安装

    虽然我对路由器没什么兴趣,但是紧跟潮流还是有必要的,现在因为网络闭关锁国政策,很多人都想自己搭配一台私人的服务器,不想被商业公司左右数据安全。我感觉这个是一个商机,建议大家可以朝这…

    Java 2023年5月30日
    086
  • LeetCode剑指Offer刷题总结(四)

    class Solution { public List> levelOrder(TreeNode root) { Deque deque = new LinkedList&…

    Java 2023年6月7日
    081
  • 对象创建过程

    通常情况下,我们创建一个对象,只需要使用new关键字即可。而对于java虚拟机来说,需要经历一系列过程。首先,需要找到对应的类是哪个,这个类是否已经加载,没有加载还需要将它先加载进…

    Java 2023年6月9日
    075
  • Java语言版的selenium

    最近在学习java 版的selenium,感叹网上是资料相对python语言版的要少很多 J昵称:DANGO的https://www.cnblogs.com/sundalian/c…

    Java 2023年5月29日
    081
  • 中小企业的福音来咯!JNPF渐火,助力业务数字化升级

    引言 随着大数据时代的到来,企业业务数字管理越来越受到企业管理人员的重视。而企业如果想要实现数字化管理的话,就需要有拥有一套能够将各环节业务相串联起来的数字化平台应用系统。以此实现…

    Java 2023年6月5日
    078
  • Java源码赏析(四)Java常见注解

    元注解 @Target :标识注解的目标,默认为所有 * ElementType.TYPE(用于类) * ElementType.FIELD(用于域,包括enum) * Eleme…

    Java 2023年6月8日
    085
亲爱的 Coder【最近整理,可免费获取】👉 最新必读书单  | 👏 面试题下载  | 🌎 免费的AI知识星球