Node.js 实现钉钉 ISV 接入的加解密与签名逻辑

作者:后端茶话时间:2026-10-21 20:25:08浏览:133

本文介绍在 Node.js 环境下实现钉钉 ISV 应用接入时的核心安全机制,涵盖消息体的 AES-256-CBC 加解密流程及基于 SHA1 的消息签名生成方法。通过解析加密密钥、初始化向量及随机字符串,确保回调数据的安全性与完整性,适用于钉钉二次开发场景。

Node.js 钉钉 ISV 安全接入概述

在开发 Worktile 的钉钉版本过程中,遇到了一个较为复杂的环节,即钉钉 ISV 接入时的数据安全性处理。为了帮助其他开发者解决类似问题,现将具体的实现思路与代码逻辑整理如下,供参考与交流。

消息解密逻辑实现

解密方法


exports.decryptMsg = function (text) {
 var aes_msg_buffer = new Buffer(text, 'base64');
 var key = new Buffer(aes_key + "=", 'base64');
 var iv = key.slice(0, 16);
 var decipher = crypto.createDecipheriv('aes-256-cbc', key, iv);
 var dec = decipher.write(aes_msg_buffer);
 dec = decipher.read();
 var msg_leng_buffer = dec.slice(16, 20);
 var msg_length = msg_leng_buffer.readInt32BE();
 var rand_buffer = dec.slice(20, 20 + msg_length);
 var msg = rand_buffer.toString("utf-8");
 var result = JSON.parse(msg);
 return result;
};

消息加密逻辑实现

加密方法


exports.encrypt_text = function (text, aes_key, suiteKey) {
 var key = new Buffer(aes_key + "=", 'base64');
 var iv = key.slice(0, 16);
 var random_buffer = new Buffer(exports.getRandomStr(16), 'utf-8');
 var buffer = new Buffer(text, 'utf-8');
 var length_buffer = new Buffer(4);
 length_buffer.writeUInt32BE(buffer.length, 0);
 var corpidBytes = new Buffer(suiteKey, 'utf-8');
 var newBuffer = Buffer.concat([random_buffer, length_buffer, buffer, corpidBytes]);
 var cipher = crypto.createCipheriv('aes-256-cbc', key, iv);
 //cipher.write(newBuffer);
 //var dec = cipher.read();
 var cipheredMsg = Buffer.concat([cipher.update(/*encoded*/newBuffer), cipher.final()]);
 return cipheredMsg.toString('base64');
};

消息签名生成方法

签名方法


var arr =[token, timestamp, nonce, res_encrypt] //token 是配置钉钉套件的token,timestamp时间戳, nonce随机字符串, res_encrypt是上面加密后的结果
exports.signature_arr = function (arr) {
 arr.sort();
 var str = "";
 for (var i = 0; i < arr.length; i++) {
  str += arr[i];
 }
 var sha1 = crypto.createHash('sha1');
 sha1.update(str);
 var msg_signature = sha1.digest('hex');
 return msg_signature;
};

上述内容介绍了基于 Node.js 实现钉钉 ISV 接入所需的加密、解密及签名方案。希望这些示例代码能对各位的开发工作有所帮助。若在实际应用中遇到任何疑问,欢迎留言讨论,作者将尽力提供解答。同时,感谢大家对本站的支持。

作者最新文章