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 示例收到的消息、保留原校验值,确认它拒绝处理。

// 请在这里编写代码

🎉 现在可以用自己的例子验证这些用法啦!