Skip to content

Commit 04e2d71

Browse files
authored
doc: clarify --use-system-ca support status
Node.js only checks trust settings of additional certificates from the system store. It does not, however, support revocation/distrust of existing certificates. PR-URL: nodejs/node#60340 Reviewed-By: Luigi Pinca <[email protected]>
1 parent 646e19e commit 04e2d71

File tree

1 file changed

+10
-10
lines changed

1 file changed

+10
-10
lines changed

doc/api/cli.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -3148,21 +3148,18 @@ On platforms other than Windows and macOS, this loads certificates from the dire
31483148
and file trusted by OpenSSL, similar to `--use-openssl-ca`, with the difference being
31493149
that it caches the certificates after first load.
31503150

3151-
On Windows and macOS, the certificate trust policy is planned to follow
3152-
[Chromium's policy for locally trusted certificates][]:
3151+
On Windows and macOS, the certificate trust policy is similar to
3152+
[Chromium's policy for locally trusted certificates][], but with some differences:
31533153

31543154
On macOS, the following settings are respected:
31553155

31563156
* Default and System Keychains
31573157
* Trust:
31583158
* Any certificate where the “When using this certificate” flag is set to “Always Trust” or
3159-
* Any certificate where the “Secure Sockets Layer (SSL)” flag is set to “Always Trust.”
3160-
* Distrust:
3161-
* Any certificate where the “When using this certificate” flag is set to “Never Trust” or
3162-
* Any certificate where the “Secure Sockets Layer (SSL)” flag is set to “Never Trust.”
3159+
* Any certificate where the “Secure Sockets Layer (SSL)” flag is set to “Always Trust”.
3160+
* The certificate must also be valid, with "X.509 Basic Policy" set to “Always Trust”.
31633161

3164-
On Windows, the following settings are respected (unlike Chromium's policy, distrust
3165-
and intermediate CA are not currently supported):
3162+
On Windows, the following settings are respected:
31663163

31673164
* Local Machine (accessed via `certlm.msc`)
31683165
* Trust:
@@ -3177,8 +3174,11 @@ and intermediate CA are not currently supported):
31773174
* Trusted Root Certification Authorities
31783175
* Enterprise Trust -> Group Policy -> Trusted Root Certification Authorities
31793176

3180-
On Windows and macOS, Node.js would check that the user settings for the certificates
3181-
do not forbid them for TLS server authentication before using them.
3177+
On Windows and macOS, Node.js would check that the user settings for the trusted
3178+
certificates do not forbid them for TLS server authentication before using them.
3179+
3180+
Node.js currently does not support distrust/revocation of certificates
3181+
from another source based on system settings.
31823182

31833183
On other systems, Node.js loads certificates from the default certificate file
31843184
(typically `/etc/ssl/cert.pem`) and default certificate directory (typically

0 commit comments

Comments
 (0)