Skip to content

Commit fc9ad56

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

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+
To use wildcard certificates, please note that `*` will only apply to the
226+
label only, this is not a limitation in Dovecot, but in TLS generally. This
227+
means that while `*.example.org` matches `mail.example.org`, but will not match
228+
`int.mail.example.org`.
229+
230+
Another important to note is that [[setting,local_name]] ordering matters. You
231+
must specify wildcard certificate first, followed by any more specific names.
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)