diff --git a/doc/api/tls.md b/doc/api/tls.md index b40273a83a5292..97a81d0392470b 100644 --- a/doc/api/tls.md +++ b/doc/api/tls.md @@ -1333,6 +1333,11 @@ decrease overall server throughput. ## `tls.checkServerIdentity(hostname, cert)` * `hostname` {string} The host name or IP address to verify the certificate @@ -1353,6 +1358,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])`