Skip to content

加密与哈希

加密是对信息进行编码的过程。此过程将信息的原始表示形式(称为明文)转换为另一种称为密文的形式。理想情况下,只有授权方才能将密文解密回明文并访问原始信息。加密本身不能防止拦截,但会使拦截者无法获取可理解的内容。加密是一个双向函数;加密的内容可以使用正确的密钥解密。

哈希是将给定的键转换为另一个值的过程。哈希函数根据数学算法生成新值。一旦完成哈希运算,应该无法从输出反推出输入。

加密

Node.js 提供了内置的 crypto 模块,你可以使用它来加密和解密字符串、数字、缓冲区、流等。Nest 本身不在此模块之上提供任何额外的包,以避免引入不必要的抽象。

作为示例,让我们使用 AES(高级加密系统)'aes-256-ctr' 算法 CTR 加密模式。

typescript
import { createCipheriv, randomBytes, scrypt } from 'node:crypto';
import { promisify } from 'node:util';

const iv = randomBytes(16);
const password = 'Password used to generate key';

// 密钥长度取决于算法。
// 在这种情况下,对于 aes256,它是 32 字节。
const key = (await promisify(scrypt)(password, 'salt', 32)) as Buffer;
const cipher = createCipheriv('aes-256-ctr', key, iv);

const textToEncrypt = 'Nest';
const encryptedText = Buffer.concat([
  cipher.update(textToEncrypt),
  cipher.final(),
]);

现在解密 encryptedText 值:

typescript
import { createDecipheriv } from 'node:crypto';

const decipher = createDecipheriv('aes-256-ctr', key, iv);
const decryptedText = Buffer.concat([
  decipher.update(encryptedText),
  decipher.final(),
]);

哈希

对于哈希,我们建议使用 bcryptargon2 包。Nest 本身不在这些模块之上提供任何额外的封装,以避免引入不必要的抽象(使学习曲线更短)。

作为示例,让我们使用 bcrypt 来哈希一个随机密码。

首先安装所需的包:

shell
$ npm i bcrypt
$ npm i -D @types/bcrypt

安装完成后,你可以使用 hash 函数,如下所示:

typescript
import * as bcrypt from 'bcrypt';

const saltOrRounds = 10;
const password = 'random_password';
const hash = await bcrypt.hash(password, saltOrRounds);

要生成盐值,使用 genSalt 函数:

typescript
const salt = await bcrypt.genSalt();

要比较/验证密码,使用 compare 函数:

typescript
const isMatch = await bcrypt.compare(password, hash);

你可以在这里了解更多可用的函数。

基于 NestJS 官方文档翻译