diff --git a/doc/api/tls.md b/doc/api/tls.md index 86644cea76b6a3..f0a5a6ba34127a 100644 --- a/doc/api/tls.md +++ b/doc/api/tls.md @@ -547,6 +547,12 @@ description are taken from deps/openssl/openssl/crypto/x509/x509_txt.c * `'CERT_REJECTED'`: Certificate rejected. * `'HOSTNAME_MISMATCH'`: Hostname mismatch. +Note: When certificate errors like `UNABLE_TO_VERIFY_LEAF_SIGNATURE`, +`DEPTH_ZERO_SELF_SIGNED_CERT`, or `UNABLE_TO_GET_ISSUER_CERT` occur, Node.js +appends a hint suggesting that if the root CA is installed locally, +try running with the `--use-system-ca` flag to direct developers towards a +secure solution, to prevent unsafe workarounds. + ## Class: `tls.CryptoStream`