Skip to content

Commit 17ad15a

Browse files
committed
config/ssl: Clarify how TLS certificates are matched.
1 parent 63c35a5 commit 17ad15a

File tree

1 file changed

+8
-0
lines changed

1 file changed

+8
-0
lines changed

docs/core/config/ssl.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -222,6 +222,14 @@ It is important to note that having multiple SSL certificates per IP will
222222
not be compatible with all clients, especially mobile ones. It is a TLS
223223
SNI limitation.
224224

225+
When using wildcard certificates, keep in mind that the `*` applies only to a single label.
226+
This is a general limitation of TLS, not Dovecot specifically.
227+
For example, `*.example.org` will match `mail.example.org` but not `int.mail.example.org`.
228+
229+
Also note that the ordering of [[link,settings_connection_filters,local_name]] is important.
230+
The wildcard certificate must be listed first, followed by more specific names. Note that the
231+
last matching [[link,settings_connection_filters,local_name]] filter will be used.
232+
225233
```[dovecot.conf]
226234
local_name imap.example.org {
227235
ssl_server_cert_file = /etc/ssl/certs/imap.example.org.crt

0 commit comments

Comments
 (0)