DOC: clarify how to create a fallback crt
authorJoao Morais <jcmoraisjr@gmail.com>
Sat, 21 Nov 2020 10:42:20 +0000 (07:42 -0300)
committerWilly Tarreau <w@1wt.eu>
Sat, 21 Nov 2020 14:29:22 +0000 (15:29 +0100)
commite51fab0a4aba977b111c9d0926d6adbaf62204a1
tree66c0b308f7f6c1bf8672ba5c9311d3daf47b9509
parented54c3baa5c661346e24e6ed0c1fcdd8bd6cedb7
DOC: clarify how to create a fallback crt

HAProxy uses CN and SAN of the certificates to match incoming SNI, and
use the matching certificate in the TLS handshake. `crt-list` goes
further and allows to configure SNI filters to explicitly define the
FQDNs that should match a certificate.

The first declared certificate of the `crt-list` option follows the same
rules, and it's also used as a fallback - the certificate that should be
used if SNI isn't provided or the provided one cannot match any
certificate or SNI filter. If a provided SNI matches the CN or SAN of
the first certificate, the first certificate would be used even if a
matching SNI filter is declared later.

This change clarifies this scenario and documents a filter that can be
used to convert the first declared certificate as a proper fallback.

Should be merged as far as the first SNI filter implementation.
doc/configuration.txt