decipher.setAAD(buffer[, options])


当使用认证的加密模式时(目前支持 GCMCCMOCBchacha20-poly1305),则 decipher.setAAD() 方法设置用于额外的认证数据(AAD)输入参数的值。

options 参数对于 GCM 是可选的。 使用 CCM 时,必须指定 plaintextLength 选项,其值必须与密文的字节长度匹配。 请参见 CCM 模式

decipher.setAAD() 方法必须在 decipher.update() 之前调用。

将字符串作为 buffer 传入时,请注意将字符串用作加密 API 的输入时的注意事项

When using an authenticated encryption mode (GCM, CCM, OCB, and chacha20-poly1305 are currently supported), the decipher.setAAD() method sets the value used for the additional authenticated data (AAD) input parameter.

The options argument is optional for GCM. When using CCM, the plaintextLength option must be specified and its value must match the length of the ciphertext in bytes. See CCM mode.

The decipher.setAAD() method must be called before decipher.update().

When passing a string as the buffer, please consider caveats when using strings as inputs to cryptographic APIs.