Node.js cipher.update() 方法

2025年2月12日 | 阅读 4 分钟

在本文中，我们将通过语法、参数和几个示例来讨论 Node.js cipher.update() 函数。

Node.js cipher.update() 方法是什么？

在 Node.js 中实现加密和解密功能的一个关键要素是 cipher.update() 方法，它是内置 crypto 模块的一部分。此方法便于在加密或解密过程中增量处理数据，主要与对称加密算法（如 AES（高级加密标准））配合使用。

cipher.update() 函数接受多个参数来处理加密或解密过程。这些参数包括要作为输入的待处理数据、数据的输入编码（例如 "binary" 或 "utf8"）以及处理后的数据的输出编码。使用加密或解密方法后，该过程将返回处理后的数据。

cipher.update() 方法的主要好处是能够有效地处理大量数据集。通过允许将数据分块增量处理，它减少了内存使用问题，尤其是在处理大型文件或流时。由于其增量处理能力，它非常适合在需要妥善处理海量数据的实际情况。

语法

它具有以下语法：

参数

data: 要处理的输入数据（Buffer、TypedArray、DataView 或字符串）。它可以作为字符串、DataView、TypedArray 或 Buffer 接收。
inputEncoding (string, optional): 输入时数据的编码。如果提供，输入数据将在处理前作为字符串进行解释。默认为 'utf8'。
outputEncoding (string, optional): 输出时数据的编码。如果提供，将以指定的编码返回包含输出数据的字符串。如果不提供，输出将作为 Buffer 返回。默认为 null。

返回值

它返回已经过加密或解密算法处理过的数据。outputEncoding 参数决定了返回值的格式。返回值是 Buffer 还是字符串取决于是否指定了 outputEncoding。

示例 1

让我们通过一个示例来说明 Node.js cipher.update() 方法。

 
//Importing the crypto module
const crypto = require('crypto');
// Defining and initializing the algorithm, password, and data
const algo_rithm = 'aes-192-cbc';
const pass_word = 'Password used to generate key';
const data = 'some clear text data';
// Generating key using scryptSync.
const key = crypto.scryptSync(pass_word, 'sugar', 24);
// Static initialization vector (IV) should be initialized.
const iv = Buffer.alloc(16, 0);
// Creating the cipher object
const cipher = crypto.createCipheriv(algo_rithm, key, iv);
// Utilising the update() method, update the cipher with the new data.
let encrypted_Data = cipher.update(data, 'utf8', 'hex');
//Update the encryption process and get the final encrypted data
encrypted_Data += cipher.final('hex');
// Displaying the encrypted data
console.log('The Encrypted Data is:', encrypted_Data);

输出

 
The Encrypted Data is: 88923547029a9f05d7511a99d6d14d5586aaa15eaa23dffa4736fc768254b73d

说明

在此示例中，此代码演示了如何在 Node.js 中使用 AES-192-CBC 加密技术加密数据。首先导入 crypto 模块。然后，定义并初始化密码、待加密数据和算法（aes-192-cbc）。使用 supplied password 和 sugar 通过 crypto.scryptSync() 方法创建密钥。使用 Buffer.alloc() 生成一个静态初始化向量（IV）。之后，使用 crypto.createCipheriv() 函数，使用 IV、密钥和算法创建一个 cipher 对象。使用 update() 方法将数据更新到 cipher 中；然后调用 final() 方法获取最终加密数据。最后，将加密数据记录到控制台。

示例 2

让我们通过另一个示例来说明 Node.js cipher.update() 方法。

 
const crypto = require('crypto');
// Defining and initializing the algorithm and password
const algo_rithm = 'aes-192-cbc';
const pass_word = 'Password used to generate key';
// Generate key asynchronously using scrypt
crypto.scrypt(pass_word, 'sugar', 24, { N: 512 }, (e, key) => {
    if (e) throw err;
    // Initializing the static initialization vector (IV)
    const iv = Buffer.alloc(16, 0);
    // Using the generated key and IV, create the cipher object.
    const cipher = crypto.createCipheriv(algo_rithm, key, iv);
    // Utilising the update() method, update the cipher with the data.
    let encrypted_Data = cipher.update('some clear text data', 'utf8', 'hex');
    // Finalize the encryption process and get the final encrypted data
    encrypted_Data += cipher.final('hex');
    // Displaying the encrypted data
    console.log('The Encrypted Data is:', encrypted_Data);
});

输出

 
The Encrypted Data is: 63c03b739852c0ae2606246282ba0c6739ca2e8b2c656354797f5f80466a7d55

说明

在此示例中，此代码演示了如何在 Node.js 中使用 AES-192-CBC 加密算法异步生成密钥并加密数据。它首先通过导入 crypto 模块定义算法（aes-192-cbc）和密码。然后，在密钥生成后，使用 crypto.scrypt() 方法（带 password、salt 和 options）异步生成密钥。在回调函数中使用 Buffer.alloc() 初始化一个静态初始化向量（IV）。使用生成的密钥和 IV 通过 crypto.createCipheriv() 创建一个 cipher 对象。然后，使用 update() 函数将数据更新到 cipher 中。使用 final() 方法获取最终加密数据。最后，创建一个包含加密数据的控制台日志。

下一主题Nodejs-crypto-getdiffiehellman-method

Node.js cipher.update() 方法