# dingtalk-callback-Crypto
钉钉回调加解密类库和对应demo

## API使用说明

1. 实例化加解密类，入参是token, aesKey, ownerKey（企业回调是corpId, 三方应用回调是suiteKey)
DingCallbackCrypto callbackCrypto = new DingCallbackCrypto(TOKEN, AES_KEY, OWNER_KEY);
2. 解密钉钉推送的数据，从http请求中获取解密参数
String decryptMsg = callbackCrypto.getDecryptMsg(msg_signature, timeStamp, nonce, encrypt);
3. 返回success的加密字符串
 Map<String, String> successMap = callbackCrypto.getEncryptedMap("success");

### 回调处理流程，以java为例

```java
            // 1. 从http请求中获取加解密参数
            String msg_signature = request.getParameter("msg_signature");
            if (msg_signature == null) {
                msg_signature = request.getParameter("signature");
            }
            String timeStamp = request.getParameter("timeStamp");
            if (timeStamp == null) {
                timeStamp = request.getParameter("timestamp");
            }
            String nonce = request.getParameter("nonce");
            String encrypt = bodyJson.getString("encrypt");

// 2. 使用加解密类型
            DingCallbackCrypto callbackCrypto = new DingCallbackCrypto(TOKEN, AES_KEY, OWNER_KEY);
            final String decryptMsg = callbackCrypto.getDecryptMsg(msg_signature, timeStamp, nonce, encrypt);

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

// 4. 根据EventType分类处理
            if ("check_url".equals(eventType)) {
                // 测试回调url的正确性
            } else if ("user_add_org".equals(eventType)) {
                // 处理通讯录用户增加时间
            } else {
                // 添加其他已注册的
            }

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

```

### Java版本 DingCallbackCrypto.java
1. JDK6,JDK7需要下载JCE无限制权限策略文件
2. 依赖commons-codes包

### python2版本 DingCallbackCrypto2.py

1. 依赖Crypto包进行AES的加解密

### python3版本 DingCallbackCrypto3.py

1. 依赖Crypto包进行AES的加解密

### php版本 DingCallbackCrypto.php

1. 依赖openssl_encrypt方法加解密，版本依赖 (PHP 5 >= 5.3.0, PHP 7)

### c#版本 DingTalkEncryptor.cs

### Golang版本 参考[https://github.com/icepy/go-dingtalk/blob/master/src/crypto.go](https://github.com/icepy/go-dingtalk/blob/master/src/crypto.go)

### Nodejs版本 参考[https://github.com/elixirChain/dingtalk-encrypt](https://github.com/elixirChain/dingtalk-encrypt)

人生得意须尽欢/dingtalk-callback-Crypto

简介

发行版

贡献者

近期动态

人生得意须尽欢/dingtalk-callback-Crypto .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

人生得意须尽欢/dingtalk-callback-Crypto