Node.js中生成安全令牌实现魔法链接的方案可行性咨询

问题描述 #

我有如下JSON数据：

{
  password: 'mySecretPwd',
  validUntil: dayjs().add(1, 'hour').toDate(),
  userId: '29038492132'
}

我希望实现类似魔法链接的功能：用户点击链接后打开网页，输入密码并提交，请求会携带用户输入的密码和链接中的令牌，服务器验证输入密码与令牌中的密码是否一致，以此完成用户验证。

我的实现代码如下：

const crypto = require('crypto')

const algorithm = 'aes-256-ctr'
const secretKey = process.env.JWT_TEST_RESULT_SECRET

export const encrypt = (text) => {
  const iv = crypto.randomBytes(16)

  const cipher = crypto.createCipheriv(algorithm, secretKey, iv)

  const encrypted = Buffer.concat([cipher.update(text), cipher.final()])

  return {
    iv: iv.toString('hex'),
    content: encrypted.toString('hex')
  }
}

由于解密需要iv，我打算将链接构造成：myUrl/<content>_<iv>，请问这种方法是否足够安全合理？

安全合理性分析与建议 #

这种实现思路有一定安全性基础，但存在可优化的点，具体分析如下：

1. 现有方案的合理之处 #

• AES-256-CTR是安全的流加密算法，只要密钥不泄露，加密内容难以被破解
• IV（初始化向量）随每次加密随机生成，避免了相同明文加密后出现相同密文的问题，符合CTR模式的安全要求
• IV本身不需要保密，CTR模式允许公开传输IV，所以把IV放在链接里是合规的

2. 存在的风险与优化建议 #

• 缺乏数据完整性校验：当前仅做加密，没有添加消息认证码（MAC）。攻击者可篡改链接中的密文或IV，服务器解密后只会得到乱码，但无法直接判断数据是否被篡改。建议加密后用HMAC-SHA256生成签名，将签名也加入链接（myUrl/<content>_<iv>_<signature>），服务器解密前先验证签名，确保数据未被篡改。
• 明文密码加密存储风险：令牌中直接加密明文密码，若令牌泄露，攻击者解密后可直接获取明文密码。更安全的做法是：服务器端存储用户密码的哈希值（如bcrypt哈希），令牌只加密userId和validUntil；用户输入密码后，服务器用输入的密码匹配数据库中的哈希值，而非在令牌中携带密码。
• URL长度隐患：将content、IV等放在URL路径中，可能因内容过多导致URL过长，触发部分浏览器或服务器的长度限制。可改用Base64URL编码替代Hex编码（更紧凑），或将参数放在URL查询参数中。
• 密钥管理需强化：用环境变量管理secretKey的做法正确，但需定期轮换密钥，避免密钥泄露后影响所有历史令牌。

3. 替代方案参考 #

如果追求更成熟的实现，可直接使用JWT（JSON Web Token）：

• JWT天然支持签名（如HS256算法），能保证数据完整性与真实性
• 可直接设置过期时间，无需自行处理有效期验证
• 无需手动处理加密、IV拼接等逻辑，简化实现流程

内容的提问来源于stack exchange，提问作者user2675468