Node.js 示例代码
覆盖「数据安全」两类密钥的核心场景:
- 数据对称加密密钥(AES-256-GCM):userSignature 生成、sessionKey 解密
- 数据签名公私钥(RSASSA-PSS):业务数据签名验签(如
gameSignature)
通用说明
- AES 部分示例分为两层:
- AES-256-GCM 工具模块(aes256gcmUtil):通用对称加解密实现,与 SUD SDK 内部加解密机制保持一致,可直接复用到任意 AES-256-GCM 场景;
- 业务封装:基于工具模块完成 Payload 构造、字段校验,分别覆盖 userSignature 生成与 sessionKey 解密。
- AES 字节布局统一为:
iv(12) || ciphertext || tag(16),再整体 Base64 编码。 - RSA 部分(§3 业务数据签名验签)提供独立的
rsaUtil工具模块,PSS 参数与 SUD OpenPaaS 服务端签名机制完全一致。 - 示例仅包含核心逻辑,生产环境需补充日志、异常兜底、监控告警等工程化处理。
环境依赖
- Node.js 12+(无需额外依赖,基于内置
crypto模块)。
通用 AES-256-GCM 工具
javascript
// aes256gcmUtil.js
const crypto = require('crypto');
const ALGORITHM = 'aes-256-gcm';
const IV_LENGTH = 12;
const TAG_LENGTH = 16;
function encrypt(plaintext, keyBase64) {
const key = Buffer.from(keyBase64, 'base64');
const iv = generateIV();
const cipher = crypto.createCipheriv(ALGORITHM, key, iv);
const cipherBytes = Buffer.concat([cipher.update(plaintext, 'utf8'), cipher.final()]);
const tag = cipher.getAuthTag();
// 与 Java/JCE 一致:iv || ciphertext || tag
return Buffer.concat([iv, cipherBytes, tag]).toString('base64');
}
function decrypt(encryptedBase64, keyBase64) {
const key = Buffer.from(keyBase64, 'base64');
const data = Buffer.from(encryptedBase64, 'base64');
const iv = data.subarray(0, IV_LENGTH);
const tag = data.subarray(data.length - TAG_LENGTH);
const cipherBytes = data.subarray(IV_LENGTH, data.length - TAG_LENGTH);
const decipher = crypto.createDecipheriv(ALGORITHM, key, iv);
decipher.setAuthTag(tag);
return Buffer.concat([decipher.update(cipherBytes), decipher.final()]);
}
function generateIV() {
return crypto.randomBytes(IV_LENGTH);
}
module.exports = { encrypt, decrypt };1. userSignature 生成
基于 aes256gcmUtil 构造鉴权 Payload 并加密:
javascript
// userSignature.js
const aes256gcm = require('./aes256gcmUtil');
const SIGNATURE_VERSION = '1';
function generateUserSignature(userId, expiresAt, base64Key) {
if (!userId || typeof userId !== 'string') {
throw new Error('user_id 不能为空');
}
if (!Number.isInteger(expiresAt) || expiresAt <= Math.floor(Date.now() / 1000)) {
throw new Error('expires_at 必须为大于当前时间的整型 Unix 时间戳(秒)');
}
const payload = JSON.stringify({
version: SIGNATURE_VERSION,
user_id: userId,
expires_at: expiresAt,
});
return aes256gcm.encrypt(payload, base64Key);
}
// 调用示例
const base64Key = '你的Base64编码的32字节AES密钥';
const userId = 'user_123456';
const expiresAt = Math.floor(Date.now() / 1000) + 24 * 3600; // 24 小时后过期
console.log('userSignature:', generateUserSignature(userId, expiresAt, base64Key));2. sessionKey 解密
基于 aes256gcmUtil 解密并校验载荷字段:
javascript
// sessionKey.js
const aes256gcm = require('./aes256gcmUtil');
function decryptSessionKey(encryptedSessionKey, base64Key, expectedUserId) {
const plaintextBytes = aes256gcm.decrypt(encryptedSessionKey, base64Key);
const payload = plaintextBytes.toString('utf8');
let parsed;
try {
parsed = JSON.parse(payload);
} catch (e) {
throw new Error('解密后的载荷不是合法 JSON: ' + e.message);
}
const { user_id: userId, session_key: sessionKey } = parsed;
if (!userId || !sessionKey) {
throw new Error('载荷缺少必要字段 user_id / session_key');
}
if (expectedUserId && userId !== expectedUserId) {
throw new Error(`user_id 不一致: 期望 ${expectedUserId}, 实际 ${userId}`);
}
return { userId, sessionKey };
}
// 调用示例
const encryptedSessionKey = 'Base64编码的encrypted_session_key';
const base64Key = '你的Base64编码的32字节AES密钥';
const expectedUserId = 'user_123456';
const { userId, sessionKey } = decryptSessionKey(encryptedSessionKey, base64Key, expectedUserId);
console.log('user_id:', userId, 'session_key:', sessionKey);3. 业务数据签名验签
基于「数据签名公私钥」对 SUD OpenPaaS 下发的业务数据载荷(如 gameSignature)进行 RSASSA-PSS 验签,PSS 参数为 SHA-256 / MGF1-SHA-256 / salt=32 / trailer=1(Node.js crypto 模块默认 trailer=1),签名值以 Base64 编码。
3.1 通用 RSA 签名/验签工具
javascript
// rsaUtil.js
const crypto = require('crypto');
const HASH_ALGORITHM = 'sha256';
const SALT_LENGTH = 32;
function sign(content, privateKeyPem) {
const signature = crypto.sign(HASH_ALGORITHM, Buffer.from(content, 'utf8'), {
key: privateKeyPem,
padding: crypto.constants.RSA_PKCS1_PSS_PADDING,
saltLength: SALT_LENGTH,
// mgf1 摘要默认与签名摘要相同(SHA-256)
});
return signature.toString('base64');
}
function verify(content, signValueBase64, publicKeyPem) {
return crypto.verify(
HASH_ALGORITHM,
Buffer.from(content, 'utf8'),
{
key: publicKeyPem,
padding: crypto.constants.RSA_PKCS1_PSS_PADDING,
saltLength: SALT_LENGTH,
},
Buffer.from(signValueBase64, 'base64')
);
}
module.exports = { sign, verify };3.2 调用示例
javascript
// verifyData.js
const rsaUtil = require('./rsaUtil');
// publicKeyPem:从 SUD OpenPaaS 管理后台获取的应用公钥(PEM 字符串)
// content: 按对应业务文档(如 gameSignature)拼接的"待验签内容"
// signature: 业务数据载荷中携带的签名值(Base64)
const publicKeyPem = `-----BEGIN PUBLIC KEY-----
...
-----END PUBLIC KEY-----`;
const content = '待验签内容';
const signature = '业务数据中携带的Base64签名值';
if (!rsaUtil.verify(content, signature, publicKeyPem)) {
throw new Error('数据验签失败,请勿信任该业务数据内容');
}
console.log('数据验签通过');