Skip to content

Commit 2ed515c

Browse files
committed
DOC: configuration: clarify 'default-crt' and implicit default certificates
Clarify the behavior of implicit default certificates when used on the same line as the default-crt keyword. Should be backported as far as 3.2
1 parent ab7358b commit 2ed515c

File tree

1 file changed

+11
-3
lines changed

1 file changed

+11
-3
lines changed

doc/configuration.txt

Lines changed: 11 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -16611,9 +16611,13 @@ crt-list <file>
1661116611

1661216612
default-crt <cert>
1661316613
This option does the same as the "crt" option, with the difference that this
16614-
certificate will be used as a default one. It is possible to add multiple
16615-
default certificates to have an ECDSA and an RSA one, having more is not
16616-
really useful.
16614+
certificate will be used as a default one as well. It is possible to add
16615+
multiple default certificates to have an ECDSA and an RSA one, having more is
16616+
not really useful.
16617+
16618+
This option does not disable implicit default certificates, if a 'crt'
16619+
certificate is declared first before any 'default-crt' or other 'crt' it will
16620+
still be used as a default certificate.
1661716621

1661816622
A default certificate is used when no "strict-sni" option is used on the bind
1661916623
line. A default certificate is provided when the servername extension was not
@@ -16622,8 +16626,12 @@ default-crt <cert>
1662216626

1662316627
Example:
1662416628

16629+
# this bind line has 2 default certificates
1662516630
bind *:443 default-crt foobar.pem.rsa default-crt foobar.pem.ecdsa crt website.pem.rsa
1662616631

16632+
# this bind line has 3 default certificates
16633+
bind *:443 crt website.pem.rsa default-crt foobar.pem.rsa default-crt foobar.pem.ecdsa
16634+
1662716635
See also the "crt" keyword.
1662816636

1662916637
curves <curves>

0 commit comments

Comments
 (0)