// app/service/sign.js const Service = require('egg').Service; const crypto = require('crypto'); class SignService extends Service { get Constants() { return { SIGN_METHOD_MD5: 'md5', SIGN_METHOD_HMAC: 'hmac', SIGN_METHOD_HMAC_SHA256: 'hmac_sha256', }; } toXml(data) { let xml = '\n'; // 添加其他数据字段 for (const [ key, value ] of Object.entries(data)) { if (![ 'flag', 'code', 'message' ].includes(key)) { xml += this.ctx.service.qimen.buildXmlNode(key, value, 1); } } return xml; } signTopRequest(params, body, secret, signMethod) { // 第一步:检查参数是否已经排序 const keys = Object.keys(params).sort(); // 第二步:把所有参数名和参数值串在一起 let query = ''; if (signMethod === this.Constants.SIGN_METHOD_MD5) { query += secret; } for (const key of keys) { const value = params[key]; if (key && value) { query += key + value; } } // 第三步:把请求主体拼接在参数后面 if (body) { query += body; } // 第四步:使用MD5/HMAC加密 let bytes; if (signMethod === this.Constants.SIGN_METHOD_HMAC) { bytes = this.encryptHMAC(query, secret); } else if (signMethod === this.Constants.SIGN_METHOD_HMAC_SHA256) { bytes = this.encryptHMACSHA256(query, secret); } else { query += secret; bytes = this.encryptMD5(query); } // 第五步:把二进制转化为大写的十六进制 return this.byte2hex(bytes); } /** * 验证TOP请求签名 * @param {Object} params - 所有字符型的TOP请求参数(包含sign参数) * @param {string} body - 请求主体内容 * @param {string} secret - 签名密钥 * @param {string} signMethod - 签名方法 * @return {boolean} 验证是否通过 */ verifyTopRequest(params, body, secret, signMethod) { // 复制参数,避免修改原参数 const verifyParams = { ...params }; // 提取签名 const receivedSign = verifyParams.sign; if (!receivedSign) { this.ctx.logger.warn('[SignService] Missing sign parameter'); return false; } // 移除签名参数,不参与签名计算 delete verifyParams.sign; // 计算签名 const calculatedSign = this.signTopRequest(verifyParams, body, secret, signMethod); // 比较签名 const isValid = receivedSign.toUpperCase() === calculatedSign.toUpperCase(); if (!isValid) { this.ctx.logger.warn('[SignService] Signature verification failed', { receivedSign: receivedSign.toUpperCase(), calculatedSign: calculatedSign.toUpperCase(), }); } return isValid; } /** * 验证请求并获取参数(移除签名相关参数) * @param {Object} params - 所有请求参数 * @param {string} body - 请求主体内容 * @param {string} secret - 签名密钥 * @param {string} signMethod - 签名方法 * @return {Object} { success: boolean, data: Object, message: string } */ verifyAndExtractParams(params, body, secret, signMethod) { try { const isValid = this.verifyTopRequest(params, body, secret, signMethod); if (!isValid) { return { success: false, data: null, message: 'Signature verification failed', }; } // 复制参数并移除签名相关字段 const cleanParams = { ...params }; delete cleanParams.sign; delete cleanParams.sign_method; return { success: true, data: cleanParams, message: 'Success', }; } catch (error) { this.ctx.logger.error('[SignService] verifyAndExtractParams error:', error); return { success: false, data: null, message: error.message, }; } } /** * 生成带签名的请求参数 * @param {Object} params - 原始参数 * @param {string} body - 请求主体内容 * @param {string} secret - 签名密钥 * @param {string} signMethod - 签名方法 * @return {Object} 带签名的参数对象 */ generateSignedParams(params, body, secret, signMethod) { const sign = this.signTopRequest(params, body, secret, signMethod); return { ...params, sign, sign_method: signMethod, }; } /** * HMAC MD5加密 * @param {string} data 待签名内容 * @param {string} secret 签名密钥 * @return {Buffer} 加密结果 */ encryptHMAC(data, secret) { const hmac = crypto.createHmac('md5', secret); hmac.update(data, 'utf8'); return hmac.digest(); } /** * HMAC SHA256加密 * @param {string} data 待签名内容 * @param {string} secret 签名密钥 * @return {Buffer} 加密结果 */ encryptHMACSHA256(data, secret) { const hmac = crypto.createHmac('sha256', secret); hmac.update(data, 'utf8'); return hmac.digest(); } /** * MD5加密 * @param {string} data 待签名内容 * @return {Buffer} 加密结果 */ encryptMD5(data) { return crypto.createHash('md5').update(data, 'utf8').digest(); } /** * 二进制转十六进制字符串(大写) * @param {Buffer} bytes 二进制数据 * @return {string} 十六进制字符串 */ byte2hex(bytes) { return Buffer.from(bytes).toString('hex').toUpperCase(); } } module.exports = SignService;