cipher.setAAD(buffer[, options])

• buffer <string> | <ArrayBuffer> | <Buffer> | <TypedArray> | <DataView>
• options <Object> stream.transform 选项
  • plaintextLength <number>
  • encoding <string> 当 buffer 是字符串时使用的字符串编码。
• 返回: <Cipher> 用于方法链。

当使用认证的加密模式时（目前支持 GCM、CCM、OCB 和 chacha20-poly1305），则 cipher.setAAD() 方法设置用于额外的认证数据（AAD）输入参数的值。

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

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

• buffer <string> | <ArrayBuffer> | <Buffer> | <TypedArray> | <DataView>
• options <Object> stream.transform options
  • plaintextLength <number>
  • encoding <string> The string encoding to use when buffer is a string.
• Returns: <Cipher> for method chaining.

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

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

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