diff --git a/doc/api/tls.md b/doc/api/tls.md index c45c778da76ac5..cdd678c56e869a 100644 --- a/doc/api/tls.md +++ b/doc/api/tls.md @@ -1460,6 +1460,11 @@ decrease overall server throughput. * `hostname` {string} The host name or IP address to verify the certificate @@ -1480,6 +1485,12 @@ the checks done with additional verification. This function is only called if the certificate passed all other checks, such as being issued by trusted CA (`options.ca`). +Earlier versions of Node.js incorrectly accepted certificates for a given +`hostname` if a matching `uniformResourceIdentifier` subject alternative name +was present (see [CVE-2021-44531][]). Applications that wish to accept +`uniformResourceIdentifier` subject alternative names can use a custom +`options.checkServerIdentity` function that implements the desired behavior. + ## `tls.connect(options[, callback])`