diff --git a/doc/api/cli.md b/doc/api/cli.md index 83dd79de1e0fb9..70f23dec561465 100644 --- a/doc/api/cli.md +++ b/doc/api/cli.md @@ -3148,21 +3148,18 @@ On platforms other than Windows and macOS, this loads certificates from the dire and file trusted by OpenSSL, similar to `--use-openssl-ca`, with the difference being that it caches the certificates after first load. -On Windows and macOS, the certificate trust policy is planned to follow -[Chromium's policy for locally trusted certificates][]: +On Windows and macOS, the certificate trust policy is similar to +[Chromium's policy for locally trusted certificates][], but with some differences: On macOS, the following settings are respected: * Default and System Keychains * Trust: * Any certificate where the “When using this certificate” flag is set to “Always Trust” or - * Any certificate where the “Secure Sockets Layer (SSL)” flag is set to “Always Trust.” - * Distrust: - * Any certificate where the “When using this certificate” flag is set to “Never Trust” or - * Any certificate where the “Secure Sockets Layer (SSL)” flag is set to “Never Trust.” + * Any certificate where the “Secure Sockets Layer (SSL)” flag is set to “Always Trust”. + * The certificate must also be valid, with "X.509 Basic Policy" set to “Always Trust”. -On Windows, the following settings are respected (unlike Chromium's policy, distrust -and intermediate CA are not currently supported): +On Windows, the following settings are respected: * Local Machine (accessed via `certlm.msc`) * Trust: @@ -3177,8 +3174,11 @@ and intermediate CA are not currently supported): * Trusted Root Certification Authorities * Enterprise Trust -> Group Policy -> Trusted Root Certification Authorities -On Windows and macOS, Node.js would check that the user settings for the certificates -do not forbid them for TLS server authentication before using them. +On Windows and macOS, Node.js would check that the user settings for the trusted +certificates do not forbid them for TLS server authentication before using them. + +Node.js currently does not support distrust/revocation of certificates +from another source based on system settings. On other systems, Node.js loads certificates from the default certificate file (typically `/etc/ssl/cert.pem`) and default certificate directory (typically