diff --git a/doc/api/crypto.md b/doc/api/crypto.md index ae121e83f22487..07976d94f82ec8 100644 --- a/doc/api/crypto.md +++ b/doc/api/crypto.md @@ -1321,6 +1321,11 @@ This property is deprecated. Please use `crypto.setFips()` and > Stability: 0 - Deprecated: Use [`crypto.createCipheriv()`][] instead. @@ -1336,7 +1341,9 @@ Creates and returns a `Cipher` object that uses the given `algorithm` and The `options` argument controls stream behavior and is optional except when a cipher in CCM mode is used (e.g. `'aes-128-ccm'`). In that case, the `authTagLength` option is required and specifies the length of the -authentication tag in bytes, see [CCM mode][]. +authentication tag in bytes, see [CCM mode][]. In GCM mode, the `authTagLength` +option is not required but can be used to set the length of the authentication +tag that will be returned by `getAuthTag()` and defaults to 16 bytes. The `algorithm` is dependent on OpenSSL, examples are `'aes192'`, etc. On recent OpenSSL releases, `openssl list-cipher-algorithms` will display the @@ -1366,6 +1373,10 @@ Adversaries][] for details.