JAVA----钉钉事件订阅回调配置

一般配置

回调地址

@ResponseBody
    @PostMapping("/dingTalkCallBack")
    public Map<String, String> dingTalkCallBack (
            @RequestParam(value = "msg_signature", required = false) String msg_signature,
            @RequestParam(value = "timestamp", required = false) String timeStamp,
            @RequestParam(value = "nonce", required = false) String nonce,
            @RequestBody(required = false) JSONObject json) {

        try {
            // 1. 从http请求中获取加解密参数
            // 2. 使用加解密类型
            // Constant.OWNER_KEY 说明：
            // 1、开发者后台配置的订阅事件为应用级事件推送，此时OWNER_KEY为应用的APP_KEY。
            // 2、调用订阅事件接口订阅的事件为企业级事件推送，
            //      此时OWNER_KEY为：企业的appkey（企业内部应用）或SUITE_KEY（三方应用）
            DingCallbackCrypto callbackCrypto = new DingCallbackCrypto(TOKEN, AES_KEY, APP_KEY);
            String encryptMsg = json.getString("encrypt");
            String decryptMsg = callbackCrypto.getDecryptMsg(msg_signature, timeStamp, nonce, encryptMsg);

            // 3. 反序列化回调事件json数据
            JSONObject eventJson = JSON.parseObject(decryptMsg);
            String eventType = eventJson.getString("EventType");

            // 4. 根据EventType分类处理
            if ("check_url".equals(eventType)) {
                // 测试回调url的正确性
                log.info("测试回调url的正确性");
            } else if ("user_add_org".equals(eventType)) {
                // 处理通讯录用户增加事件
                log.info("发生了：" + eventType + "事件");
            } else {
                // 添加其他已注册的
                log.info("发生了：" + eventType + "事件");
            }

            // 5. 返回success的加密数据
            Map<String, String> successMap = callbackCrypto.getEncryptedMap("success");
            log.info(successMap.toString());
            return successMap;

        } catch (Exception e) {
            e.printStackTrace();
        }
        return null;
    }

加密文件

https://github.com/open-dingtalk/dingtalk-callback-Crypto/blob/main/DingCallbackCrypto.java

结果

配置成功后，根据业务需求开启相关事件，后台根据相关事件类型做业务处理

回调异常1：java.lang.IllegalArgumentException: Last encoded character

原因：

org.apache.commons.codec.binary.Base64类
commons-codec 在 1.13 版本引入了 validateCharacter 方法,来验证在上下文中是否可以解码最后的尾随字符,生成的 EncodingAESKey 无法通过校验

解决：

1. 可以降低commons-codec 版本1.11
2. （推荐）可以自定义手动生成ase_key，填入钉钉输入框

Base64.encodeBase64String(UUID.randomUUID().toString().replaceAll("-","").getBytes());