Skip to content

Commit

Permalink
reference/ca-certificates: Update Nextclade section with its new conf…
Browse files Browse the repository at this point in the history
…igurability

Not having to say here, "There's nothing you can do", was the driving
reason for me adding said configurability to Nextclade in the first
place!

Related-to: <nextstrain/nextclade#1536>
  • Loading branch information
tsibley committed Oct 22, 2024
1 parent 466d757 commit cbda705
Showing 1 changed file with 20 additions and 8 deletions.
28 changes: 20 additions & 8 deletions src/reference/ca-certificates.rst
Original file line number Diff line number Diff line change
Expand Up @@ -157,23 +157,35 @@ Set the |REQUESTS_CA_BUNDLE|_ environment variable to override.
Nextclade CLI
-------------

*Applies to Nextclade v3.*
*Applies to Nextclade v3.9.0 and onwards.*

Uses its own bundled snapshot of `Mozilla's CA trust store`_ via the
|webpki-roots|_ Rust crate (by way of the ``reqwest`` crate's
|rustls-tls-webpki-roots feature|_).
Uses CA certificates extracted from the OS-level trust store via the
|rustls-native-certs|_ Rust crate plus its own bundled snapshot of `Mozilla's
CA trust store`_ via the |webpki-roots|_ Rust crate (by way of the ``reqwest``
crate's |rustls-tls-webpki-roots feature|_).

There is currently no way to configure or modify the trust store without
modifying the Nextclade source code.
Set the OpenSSL-style ``SSL_CERT_FILE`` or ``SSL_CERT_DIR`` environment
variables to override the OS-level trust store (on all platforms, not just
those using :ref:`OpenSSL <openssl>`). The bundled trust store is always
included and cannot be overridden or disabled.

.. I have a fix in-flight for ↑ that. —trs, 10 Oct 2024
Set the |NEXTCLADE_EXTRA_CA_CERTS|_ environment variable to add CA
certificates to the default trust store.

.. note:: Nextclade v3.8.2 and earlier provides no way to configure or modify
the trust store.

.. |rustls-native-certs| replace:: ``rustls-native-certs``
.. _rustls-native-certs: https://docs.rs/crate/rustls-native-certs/0.8.0

.. |webpki-roots| replace:: ``webpki-roots``
.. _webpki-roots: https://docs.rs/webpki-roots/0.26.6/webpki_roots/
.. _webpki-roots: https://docs.rs/crate/webpki-roots/0.26.6

.. |rustls-tls-webpki-roots feature| replace:: ``rustls-tls-webpki-roots`` feature
.. _rustls-tls-webpki-roots feature: https://docs.rs/reqwest/0.12.8/reqwest/#optional-features

.. |NEXTCLADE_EXTRA_CA_CERTS| replace:: ``NEXTCLADE_EXTRA_CA_CERTS``
.. _NEXTCLADE_EXTRA_CA_CERTS: https://docs.nextstrain.org/projects/nextclade/en/3.9.0/user/nextclade-cli/reference.html#nextclade-dataset-get


.. _aws-cli:
Expand Down

0 comments on commit cbda705

Please sign in to comment.