Skip to content

Commit 400a369

Browse files
committed
fixed default CA param descriptions, added zip files with default CAs
1 parent 4162d27 commit 400a369

File tree

4 files changed

+18
-7
lines changed

4 files changed

+18
-7
lines changed
58.1 KB
Binary file not shown.
43.2 KB
Binary file not shown.
9.13 KB
Binary file not shown.

docs/src/operations/v2.1.0/root-certificates.md

Lines changed: 18 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -16,8 +16,10 @@ X.509 certificates of default trusted CAs are stored as individual .pem files co
1616
Defaults are configured for the list of issuing, intermediate and root CAs used for validating client certificates (Apache httpd mod_ssl configuration option [SSLCACertificatePath](https://httpd.apache.org/docs/2.4/mod/mod_ssl.html#sslcacertificatepath)) as well as the CA Certificates for defining acceptable CA names (option [SSLCADNRequestPath](https://httpd.apache.org/docs/2.4/mod/mod_ssl.html#sslcadnrequestpath)). The default values of the following environment variables point to folders containing .pem files with one file per trusted CA:
1717
* [SSL_CA_CERTIFICATE_PATH](fhir-reverse-proxy/configuration.html#ssl-ca-certificate-path)
1818
Default Value: `ca/client_ca_chains`
19+
Default Folder Content: [client_ca_chains.zip](/download/2.1.0/client_ca_chains.zip)
1920
* [SSL_CA_DN_REQUEST_PATH](fhir-reverse-proxy/configuration.html#ssl-ca-dn-request-path)
2021
Default Value: `ca/client_issuing_cas`
22+
Default Folder Content: [client_issuing_cas.zip](/download/2.1.0/client_issuing_cas.zip)
2123

2224
Use docker bind mounts to replace all default files or add additional CAs to the folders.
2325

@@ -38,18 +40,23 @@ See the [BPE Server configuration](#bpe-server) for an example.
3840

3941
If you can't override the default configuration with bind-mounts, you can use the following environment variables to configure non default .pem file directories or .pem file:
4042
* [DEV_DSF_SERVER_AUTH_TRUST_CLIENT_CERTIFICATE_CAS](fhir/configuration.html#dev-dsf-server-auth-trust-client-certificate-cas)
41-
Default Value: [ca/client_ca_chains](/download/1.9.0/client_cert_ca_chains.pem)
43+
Default Value: `ca/client_ca_chains`
44+
Default Folder Content: [client_ca_chains.zip](/download/2.1.0/client_ca_chains.zip)
4245
* [DEV_DSF_FHIR_CLIENT_TRUST_SERVER_CERTIFICATE_CAS](fhir/configuration.html#dev-dsf-fhir-client-trust-server-certificate-cas)
43-
Default Value: [ca/server_root_cas](/download/1.9.0/server_cert_root_cas.pem)
46+
Default Value: `ca/server_root_cas`
47+
Default Folder Content: [server_root_cas.zip](/download/2.1.0/server_root_cas.zip)
4448
* [DEV_DSF_SERVER_AUTH_OIDC_PROVIDER_CLIENT_TRUST_SERVER_CERTIFICATE_CAS](fhir/configuration.html#dev-dsf-server-auth-oidc-provider-client-trust-server-certificate-cas)
45-
Default Value: [ca/server_root_cas](/download/1.9.0/server_cert_root_cas.pem)
49+
Default Value: `ca/server_root_cas`
50+
Default Folder Content: [server_root_cas.zip](/download/2.1.0/server_root_cas.zip)
4651

4752
### BPE Reverse Proxy
4853
Defaults are configured for the list of issuing, intermediate and root CAs used for validating client certificates (Apache httpd mod_ssl configuration option [SSLCACertificatePath](https://httpd.apache.org/docs/2.4/mod/mod_ssl.html#sslcacertificatepath)) as well as the CA Certificates for defining acceptable CA names (option [SSLCADNRequestPath](https://httpd.apache.org/docs/2.4/mod/mod_ssl.html#sslcadnrequestpath)). The default values of the following environment variables point to folders containing .pem files with one file per trusted CA:
4954
* [SSL_CA_CERTIFICATE_PATH](bpe-reverse-proxy/configuration.html#ssl-ca-certificate-path)
5055
Default Value: `ca/client_ca_chains`
56+
Default Folder Content: [client_ca_chains.zip](/download/2.1.0/client_ca_chains.zip)
5157
* [SSL_CA_DN_REQUEST_PATH](bpe-reverse-proxy/configuration.html#ssl-ca-dn-request-path)
5258
Default Value: `ca/client_issuing_cas`
59+
Default Folder Content: [client_issuing_cas.zip](/download/2.1.0/client_issuing_cas.zip)
5360

5461
Use docker bind mounts to replace all default files or add additional CAs to the folders.
5562

@@ -81,13 +88,17 @@ services:
8188

8289
Use the following environment variable to configure non default .pem files or override the existing files using docker bind mounts:
8390
* [DEV_DSF_SERVER_AUTH_TRUST_CLIENT_CERTIFICATE_CAS](bpe/configuration.html#dev-dsf-server-auth-trust-client-certificate-cas)
84-
Default Value: [ca/client_ca_chains](/download/1.9.0/client_cert_ca_chains.pem)
91+
Default Value: `ca/client_ca_chains`
92+
Default Folder Content: [client_ca_chains.zip](/download/2.1.0/client_ca_chains.zip)
8593
* [DEV_DSF_BPE_FHIR_CLIENT_TRUST_SERVER_CERTIFICATE_CAS](bpe/configuration.html#dev-dsf-bpe-fhir-client-trust-server-certificate-cas)
86-
Default Value: [ca/server_root_cas](/download/1.9.0/server_cert_root_cas.pem)
94+
Default Value: `ca/server_root_cas`
95+
Default Folder Content: [server_root_cas.zip](/download/2.1.0/server_root_cas.zip)
8796
[DEV_DSF_BPE_MAIL_TRUST_SERVER_CERTIFICATE_CAS](bpe/configuration.html#dev-dsf-bpe-mail-trust-server-certificate-cas)
88-
Default Value: [ca/server_root_cas](/download/1.9.0/server_cert_root_cas.pem)
97+
Default Value: `ca/server_root_cas`
98+
Default Folder Content: [server_root_cas.zip](/download/2.1.0/server_root_cas.zip)
8999
* [DEV_DSF_SERVER_AUTH_OIDC_PROVIDER_CLIENT_TRUST_SERVER_CERTIFICATE_CAS](bpe/configuration.html#dev-dsf-server-auth-oidc-provider-client-trust-server-certificate-cas)
90-
Default Value: [ca/server_root_cas](/download/1.9.0/server_cert_root_cas.pem)
100+
Default Value: `ca/server_root_cas`
101+
Default Folder Content: [server_root_cas.zip](/download/2.1.0/server_root_cas.zip)
91102

92103
## List of Default Trusted Certificate Authorities
93104
If not mentioned explicitly, issuing CAs listed will sign X.509 certificates with [Extended Key Usage](https://datatracker.ietf.org/doc/html/rfc5280#section-4.2.1.12) entries `TLS WWW server authentication` and `TLS WWW client authentication`.

0 commit comments

Comments
 (0)