Skip to content

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('数据验签通过');