Skip to content

Commit

Permalink
reference/ca-certificates: Note that running c_rehash on SSL_CERT_DIR…
Browse files Browse the repository at this point in the history
… is required

This is an important detail that someone generally unfamiliar with these
configurations would easily miss and then wonder why their certs weren't
being picked up.  The requirement applies not just to applications using
OpenSSL, but often also to applications that use other TLS libraries and
support SSL_CERT_DIR for compatibility.
  • Loading branch information
tsibley committed Oct 21, 2024
1 parent 6729396 commit 3d95aff
Showing 1 changed file with 2 additions and 1 deletion.
3 changes: 2 additions & 1 deletion src/reference/ca-certificates.rst
Original file line number Diff line number Diff line change
Expand Up @@ -68,7 +68,8 @@ OpenSSL is the most common library used to provide TLS/SSL support in
application software. Its `default locations of trusted CA certificates
<https://docs.openssl.org/3.0/man3/SSL_CTX_load_verify_locations/>`__ can be
overridden by setting the ``SSL_CERT_FILE`` and/or ``SSL_CERT_DIR`` environment
variables.
variables. Filenames in the latter must be hashed with OpenSSL's ``c_rehash``
utility.

Its final trust store is built from certificates in all default locations, so
to *comprehensively* override the defaults, all locations must be overridden.
Expand Down

0 comments on commit 3d95aff

Please sign in to comment.