doc: document that an empty OPENSSL_CONF skips config loading · nodejs/node@24cd694 · GitHub
Skip to content

Commit 24cd694

Browse files
orgadsclaude
authored andcommitted
doc: document that an empty OPENSSL_CONF skips config loading
A default OpenSSL configuration file that exists but cannot be read is fatal at startup: CONF_MFLAGS_IGNORE_MISSING_FILE only covers ENOENT and ENOTDIR, so a container that mounts /etc/ssl inaccessible to the user Node.js runs as cannot start at all. OpenSSL skips config loading entirely when OPENSSL_CONF is set to an empty value, which gets past this, but that was undocumented. Say so, including that no configuration is applied, FIPS setup included. Refs: #62230 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Signed-off-by: Orgad Shaneh <orgad.shaneh@audiocodes.com> PR-URL: #64949 Fixes: #62230 Reviewed-By: Filip Skokan <panva.ip@gmail.com>
1 parent 78175c6 commit 24cd694

3 files changed

Lines changed: 55 additions & 2 deletions

File tree

doc/api/cli.md

Lines changed: 8 additions & 1 deletion

doc/node.1

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2378,8 +2378,14 @@ environment variable is arbitrary.
23782378
.It Ev OPENSSL_CONF Ar file
23792379
Load an OpenSSL configuration file on startup. The file can be used as part of
23802380
a FIPS mode configuration.
2381+
If the variable is set to an empty value, Node.js starts without loading any
2382+
OpenSSL configuration file. This is a way past a default configuration file
2383+
that exists but cannot be read, for example when \fB/etc/ssl\fR is not accessible
2384+
to the user Node.js runs as, which is otherwise fatal at startup. No
2385+
configuration is applied in that case, including any FIPS mode setup the
2386+
file would have performed.
23812387
If the \fB--openssl-config\fR command-line option is used, the environment
2382-
variable is ignored.
2388+
variable is ignored, and an empty value has no effect.
23832389
.
23842390
.It Ev SSL_CERT_DIR Ar dir
23852391
If \fB--use-openssl-ca\fR is enabled, or if \fB--use-system-ca\fR is enabled on
Lines changed: 40 additions & 0 deletions

0 commit comments

Comments
 (0)