diff --git a/doc/api/crypto.md b/doc/api/crypto.md index abf8a19f9bc9cb..32cf5215597b37 100644 --- a/doc/api/crypto.md +++ b/doc/api/crypto.md @@ -925,6 +925,11 @@ When passing a string as the `buffer`, please consider -Type: Runtime +Type: End-of-Life -Applications that intend to use authentication tags that are shorter than the -default authentication tag length must set the `authTagLength` option of the +For ciphers in GCM mode, the [`decipher.setAuthTag()`][] function used to accept +authentication tags of any valid length (see also [DEP0090](#DEP0090)). This +exception has been removed to better align with recommendations per +[NIST SP 800-38D][], and applications that intend to use authentication tags +that are shorter than the default authentication tag length (i.e., shorter than +16 bytes for AES-GCM) must explicitly set the `authTagLength` option of the [`crypto.createDecipheriv()`][] function to the appropriate length. -For ciphers in GCM mode, the [`decipher.setAuthTag()`][] function accepts -authentication tags of any valid length (see [DEP0090](#DEP0090)). This behavior -is deprecated to better align with recommendations per [NIST SP 800-38D][]. - ### DEP0183: OpenSSL engine-based APIs