Node.js cipher.getAuthTag() 方法

2025 年 2 月 11 日 | 3 分钟阅读

在 Node.js 中，使用特定加密模式（如 GCM - Galois/Counter Mode）加密时生成的身份验证标签，可以通过 getAuthTag() 方法 来检索。它是 Node.js crypto 模块的一部分。

当使用 GCM 等模式加密数据时，除了密文外还会生成一个身份验证标签。此标签有助于检测对加密数据进行的任何未经授权的更改，并确保其完整性和有效性。

语法

它具有以下语法：

参数： 此方法不接受任何参数。

返回值： 此方法返回一个缓冲区，其中包含根据给定数据计算出的身份验证标签。

getAuthTag() 如何工作？

加密

当使用 AES-GCM 等加密算法加密数据时，会使用 crypto 创建一个 cipher 实例。通过 `createCipheriv(algorithm, key, iv)` 定义加密算法、加密密钥和初始化向量 (IV)。然后，通过使用新的数据更新 cipher 来完成加密过程。

身份验证标签

在加密过程中，cipher 会自动生成身份验证标签。

获取身份验证标签

加密完成后，可以使用 cipher 实例上的 getAuthTag() 函数来获取身份验证标签。

验证

数据解密需要身份验证标签和密文。解密完成后，您可以使用获得的身份验证标签进行验证。如果标签与加密时生成的标签不同，则可能表示数据已被更改。

 
const crypto = require('crypto');
const algorithm = 'aes-256-gcm';
const key = crypto.randomBytes(32); 
const iv = crypto.randomBytes(16); 
const cipher = crypto.createCipheriv(algorithm, key, iv);
let encrypted = cipher.update('Hello, world!', 'utf8', 'hex');
encrypted += cipher.final('hex');
const authTag = cipher.getAuthTag();  

请记住，身份验证标签对于确保加密数据的完整性和有效性至关重要，尤其是在 GCM 等模式下，它同时充当加密和身份验证机制。为了防止在解密过程中对数据进行意外更改，安全地处理并仔细验证它至关重要。

示例 1

让我们通过一个示例来说明 Node.js 的 cipher.getAuthTag()。

 
const crypto = require('crypto'),
algorithm = 'aes-256-gcm',
password = '3zTvzr3p67VC61jmV54rIYu1545x4TlY',
iv = '60iP0h6vJoEa'
function encrypt(text) {
let cipher = crypto.createCipheriv(algorithm, password, iv)
let encrypted = cipher.update(text, 'utf8', 'hex')
encrypted += cipher.final('hex');
let tag = cipher.getAuthTag();
return {
content: encrypted,
tag: tag
};
}
let output = encrypt("javatpoint")
console.log(output);   

输出

 
{
  content: '7ae236f3604d26471bb9',
  tag: <Buffer 93 60 25 74 0e 1f 11 c7 33 b2 4e c9 ed 6a ae 42>
}