cipher.setAAD(buffer[, options])

• buffer <string> | <ArrayBuffer> | <Buffer> | <TypedArray> | <DataView>

• options <Object> stream.transform 选项

  ¥options <Object> stream.transform options

  • plaintextLength <number>

  • encoding <string> 当 buffer 是字符串时使用的字符串编码。

    ¥encoding <string> The string encoding to use when buffer is a string.

• 返回：<Cipher> 用于方法链接的相同 Cipher 实例。

  ¥Returns: <Cipher> The same Cipher instance for method chaining.

当使用经过身份验证的加密模式（当前支持 GCM、CCM、OCB 和 chacha20-poly1305）时，cipher.setAAD() 方法设置用于附加身份验证数据 (AAD) 输入参数的值。

¥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.

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

¥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.

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

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