crypto:生成摘要、随机值和消息校验值
🎯 引言
学完这篇文章,你能用 crypto 校验内容、生成文件标识和访问令牌。示例使用 Node.js 24.19.0,无需安装包;各节单独保存为 .mjs 文件运行。
🧾 哈希摘要:检查内容是否变化
摘要用于检查内容是否变化,例如核对下载文件。 相同内容会得到相同摘要,将计算结果与可信来源提供的摘要比较即可。
下面用 hello 模拟下载内容,保存为 hash.mjs:
import { createHash } from 'node:crypto'
const hash = createHash('sha256')
hash.update('hello', 'utf8')
const actual = hash.digest('hex')
console.log(actual)
sha256 指定摘要算法;update 输入要处理的文字,utf8 指定编码;digest 完成计算,hex 将结果表示为十六进制字符串。这个例子输出:
2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824
假设可信来源公布的摘要如下,在同一文件中追加比较:
const expected = '2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824'
console.log(actual === expected ? '内容校验通过' : '内容不匹配,请重新检查')
运行 node hash.mjs,会在摘要后输出 内容校验通过。把前面输入的 hello 改成 Hello 后重新运行,会输出 内容不匹配,请重新检查。
每次独立计算应重新创建 hash 对象,已经执行 digest 的对象不能继续当作新的计算使用。
摘要不能还原原文;用于校验的参考摘要必须来自可信来源。
🏷️ randomUUID:给上传文件生成保存名称
randomUUID 用于生成记录或文件的随机标识,例如为上传图片生成保存名称,减少同名文件冲突。
下面假设上传内容已经确认为 PNG,单独保存为 file-name.mjs:
import { randomUUID } from 'node:crypto'
const fileName = `${randomUUID()}.png`
console.log(fileName)
运行后输出形如 7f52c1d2-6de8-4b4d-8c31-ae81b8bb4b10.png 的名称,实际值每次运行通常不同。UUID 是一种通用标识格式,randomUUID 返回其中的随机版本。
将生成的名称用于文件保存路径即可;这段代码只生成名称,不创建文件。
🎲 randomBytes:生成临时下载令牌
randomBytes 用于生成难以猜中的随机值,例如临时下载令牌。 令牌是用户下载时提交给服务的访问凭证。
先生成令牌值,单独保存为 download-token.mjs:
import { randomBytes } from 'node:crypto'
const token = randomBytes(16).toString('hex')
console.log(token)
16 是随机字节数量。每个字节以两个十六进制字符显示,因此结果是 32 个字符,具体内容不固定。
令牌被猜中就可能被冒用,因此需要难以预测的随机值。randomBytes 适合安全用途,Math.random 不提供这种安全保证。
服务需保存令牌对应的文件和到期时间;用户下载时提交令牌,服务核对后才返回文件。randomBytes 只生成值,不负责保存或过期处理。
🔑 HMAC:校验服务收到的消息是否被改动
HMAC 用于校验双方服务之间的消息,例如文件转换完成通知。 它把消息和保密密钥一起计算;接收方重新计算并比较,发现不一致就拒绝处理。
下面在 message-check.mjs 中模拟发送和校验,同节代码依次追加。
发送方:计算消息的校验值
import { createHmac, timingSafeEqual } from 'node:crypto'
const key = 'demo-key'
const message = 'file=report.pdf&status=ready'
const sentTag = createHmac('sha256', key).update(message, 'utf8').digest()
createHmac 指定 SHA-256 算法与密钥,update 输入消息,digest() 返回 32 字节的 Buffer 校验值。demo-key 仅用于练习;真实密钥由双方保密保存,不随消息发送。
接收方:对收到的消息重新计算
在同一文件后追加:
const receivedMessage = message
const receivedTag = sentTag
const expectedTag = createHmac('sha256', key).update(receivedMessage, 'utf8').digest()
receivedMessage 和 receivedTag 模拟请求中的消息与校验值。接收方应按收到的原始内容计算,不能先改动格式。
比较结果,再决定是否处理消息
const valid = receivedTag.length === expectedTag.length
&& timingSafeEqual(receivedTag, expectedTag)
console.log(valid ? '校验通过,可以处理消息' : '校验失败,拒绝处理')
运行 node message-check.mjs,输出 校验通过,可以处理消息。将 receivedMessage 的赋值改为字符串 'file=report.pdf&status=failed',保持 receivedTag 不变,再运行会输出 校验失败,拒绝处理。
timingSafeEqual 比较两个等长 Buffer 是否相同,返回布尔值。它适合比较 HMAC 校验值,避免比较过程因相同前缀的长短而泄露计时线索;长度不同时会抛错,所以代码先检查长度。
HMAC 不会隐藏消息内容,也不会阻止同一份有效消息被重复发送。
❓ 知识问答
Q1:Base64 或十六进制表示能保密吗?
不能,它们只是表示字节的方式,知道规则就能还原字节。
Q2:为什么第二次调用 digest 会报错?
一次 digest 会结束当前计算。要比较另一段内容,需要重新调用 createHash,创建新的计算对象。
Q3:随机标识可以直接授予权限吗?
不可以,是否有权限由服务规则判断,不是由字符串是否随机决定。
🧪 小练习
先修改摘要示例的输入,确认它能提示内容不匹配;再只修改 HMAC 示例收到的消息、保留原校验值,确认它拒绝处理。
// 请在这里编写代码
🎉 现在可以用自己的例子验证这些用法啦!
