f

2026-05-27 16:57:43 +08:00
commit 8c1a09f075
195 changed files with 73506 additions and 0 deletions
--- a/public/examples/javascript/sms_signature_demo.js
+++ b/public/examples/javascript/sms_signature_demo.js
@@ -0,0 +1,266 @@
+/**
+ * 短信发送接口签名示例（浏览器版本）
+ *
+ * 本示例演示如何在浏览器中为短信发送接口生成HMAC-SHA256签名
+ *
+ * 安全提示：
+ * 1. 密钥应该通过代码混淆、字符串拆分等方式隐藏
+ * 2. 不要在前端代码中直接暴露完整密钥
+ * 3. 建议使用构建工具进行代码混淆和压缩
+ * 4. 可以考虑将签名逻辑放在后端代理接口中
+ */
+
+/**
+ * 获取签名密钥（通过多种方式混淆，增加破解难度）
+ * 注意：这只是示例，实际使用时应该进一步混淆
+ */
+function getSecretKey() {
+  // 方式1: 字符串拆分和拼接
+  const part1 = 'HyApi2026'
+  const part2 = 'SMSSecret'
+  const part3 = 'Key!@#$%^'
+  const part4 = '&*()_+QWERTY'
+  const part5 = 'UIOP'
+
+  // 方式2: 使用数组和join（增加混淆）
+  const arr = [part1, part2, part3, part4, part5]
+  return arr.join('')
+
+  // 方式3: 字符数组拼接（更复杂的方式）
+  // const chars = ['T', 'y', 'A', 'p', 'i', '2', '0', '2', '4', ...];
+  // return chars.join('');
+
+  // 方式4: 使用atob解码（如果密钥经过base64编码）
+  // const encoded = 'base64_encoded_string';
+  // return atob(encoded);
+}
+
+/**
+ * 生成随机字符串（用于nonce）
+ */
+function generateNonce(length = 16) {
+  const chars = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789'
+  let result = ''
+  const array = new Uint8Array(length)
+  crypto.getRandomValues(array)
+  for (let i = 0; i < length; i++) {
+    result += chars[array[i] % chars.length]
+  }
+  return result
+}
+
+/**
+ * 使用Web Crypto API生成HMAC-SHA256签名
+ *
+ * @param {Object} params - 请求参数对象
+ * @param {string} secretKey - 签名密钥
+ * @param {number} timestamp - 时间戳（秒）
+ * @param {string} nonce - 随机字符串
+ * @returns {Promise<string>} 签名字符串（hex编码）
+ */
+async function generateSignature(params, secretKey, timestamp, nonce) {
+  // 1. 构建待签名字符串：按key排序，拼接成 key1=value1&key2=value2 格式
+  const keys = Object.keys(params)
+    .filter((k) => k !== 'signature') // 排除签名字段
+    .sort()
+
+  const parts = keys.map((k) => `${k}=${params[k]}`)
+
+  // 2. 添加时间戳和随机数
+  parts.push(`timestamp=${timestamp}`)
+  parts.push(`nonce=${nonce}`)
+
+  // 3. 拼接成待签名字符串
+  const signString = parts.join('&')
+
+  // 4. 使用Web Crypto API计算HMAC-SHA256签名
+  const encoder = new TextEncoder()
+  const keyData = encoder.encode(secretKey)
+  const messageData = encoder.encode(signString)
+
+  // 导入密钥
+  const cryptoKey = await crypto.subtle.importKey(
+    'raw',
+    keyData,
+    { name: 'HMAC', hash: 'SHA-256' },
+    false,
+    ['sign'],
+  )
+
+  // 计算签名
+  const signature = await crypto.subtle.sign('HMAC', cryptoKey, messageData)
+
+  // 转换为hex字符串
+  const hashArray = Array.from(new Uint8Array(signature))
+  const hashHex = hashArray.map((b) => b.toString(16).padStart(2, '0')).join('')
+
+  return hashHex
+}
+
+/**
+ * 自定义编码字符集（与后端保持一致）
+ */
+const CUSTOM_ENCODE_CHARSET =
+  '0123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghjkmnpqrstuvwxyz!@#$%^&*()_+-=[]{}|;:,.<>?'
+
+/**
+ * 自定义Base64编码（使用自定义字符集）
+ */
+function customBase64Encode(data) {
+  if (data.length === 0) return ''
+
+  // 将字符串转换为UTF-8字节数组
+  const encoder = new TextEncoder()
+  const bytes = encoder.encode(data)
+  const charset = CUSTOM_ENCODE_CHARSET
+  let result = ''
+
+  // 将3个字节（24位）编码为4个字符
+  for (let i = 0; i < bytes.length; i += 3) {
+    const b1 = bytes[i]
+    const b2 = i + 1 < bytes.length ? bytes[i + 1] : 0
+    const b3 = i + 2 < bytes.length ? bytes[i + 2] : 0
+
+    // 组合成24位
+    const combined = (b1 << 16) | (b2 << 8) | b3
+
+    // 分成4个6位段
+    result += charset[(combined >> 18) & 0x3f]
+    result += charset[(combined >> 12) & 0x3f]
+
+    if (i + 1 < bytes.length) {
+      result += charset[(combined >> 6) & 0x3f]
+    } else {
+      result += '=' // 填充字符
+    }
+
+    if (i + 2 < bytes.length) {
+      result += charset[combined & 0x3f]
+    } else {
+      result += '=' // 填充字符
+    }
+  }
+
+  return result
+}
+
+/**
+ * 应用字符偏移混淆
+ */
+function applyCharShift(data, shift) {
+  const charset = CUSTOM_ENCODE_CHARSET
+  const charsetLen = charset.length
+  let result = ''
+
+  for (let i = 0; i < data.length; i++) {
+    const c = data[i]
+    if (c === '=') {
+      result += c // 填充字符不变
+      continue
+    }
+
+    const idx = charset.indexOf(c)
+    if (idx === -1) {
+      result += c // 不在字符集中，保持不变
+    } else {
+      // 应用偏移
+      const newIdx = (idx + shift) % charsetLen
+      result += charset[newIdx]
+    }
+  }
+
+  return result
+}
+
+/**
+ * 自定义编码请求数据
+ */
+function encodeRequest(data) {
+  // 1. 使用自定义Base64编码
+  const encoded = customBase64Encode(data)
+
+  // 2. 应用字符偏移混淆（偏移7个位置）
+  const confused = applyCharShift(encoded, 7)
+
+  return confused
+}
+
+/**
+ * 发送短信验证码（带签名）- 方式2：编码后传输（推荐，更安全）
+ * 将所有参数（包括签名）使用自定义编码方案编码后传输，隐藏参数结构
+ *
+ * @param {string} phone - 手机号
+ * @param {string} scene - 场景（register/login/change_password/reset_password等）
+ * @param {string} apiBaseUrl - API基础URL
+ * @returns {Promise<Object>} 响应结果
+ */
+async function sendSMSWithEncodedSignature(phone, scene, apiBaseUrl = 'http://localhost:8080') {
+  // 1. 准备参数
+  const timestamp = Math.floor(Date.now() / 1000) // 当前时间戳（秒）
+  const nonce = generateNonce(16) // 生成随机字符串
+
+  const params = {
+    phone: phone,
+    scene: scene,
+  }
+
+  // 2. 生成签名
+  const secretKey = getSecretKey()
+  const signature = await generateSignature(params, secretKey, timestamp, nonce)
+
+  // 3. 构建包含所有参数的JSON对象
+  const allParams = {
+    phone: phone,
+    scene: scene,
+    timestamp: timestamp,
+    nonce: nonce,
+    signature: signature,
+  }
+
+  // 4. 将JSON对象转换为字符串，然后使用自定义编码方案编码
+  const jsonString = JSON.stringify(allParams)
+  const encodedData = encodeRequest(jsonString)
+
+  // 5. 构建请求体（只包含编码后的data字段）
+  const requestBody = {
+    data: encodedData,
+  }
+
+  // 6. 发送请求
+  try {
+    const response = await fetch(`${apiBaseUrl}/api/v1/users/send-code`, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+      },
+      body: JSON.stringify(requestBody),
+    })
+
+    const result = await response.json()
+    return result
+  } catch (error) {
+    console.error('发送短信失败:', error)
+    throw error
+  }
+}
+
+// 如果在浏览器环境中使用，可以导出到全局
+if (typeof window !== 'undefined') {
+  window.SMSSignature = {
+    sendSMSWithEncodedSignature,
+    generateSignature,
+    generateNonce,
+    encodeRequest,
+  }
+}
+
+// 如果在Node.js环境中使用（需要安装crypto-js等库）
+if (typeof module !== 'undefined' && module.exports) {
+  module.exports = {
+    sendSMSWithEncodedSignature,
+    generateSignature,
+    generateNonce,
+    getSecretKey,
+    encodeRequest,
+  }
+}