Browse Source

unbreak CertificateFile documentation

the file may in fact contain CA certs.

amends 7d9d3e15.
wip/unchecked-remove
Oswald Buddenhagen 4 years ago
parent
commit
09540b5648
  1. 32
      src/mbsync.1

32
src/mbsync.1

@ -379,17 +379,27 @@ if you want to trust only hand-picked certificates.
\fBCertificateFile\fR \fIpath\fR \fBCertificateFile\fR \fIpath\fR
File containing additional X.509 certificates used to verify server File containing additional X.509 certificates used to verify server
identities. identities.
These certificates are always trusted, regardless of validity. It may contain two types of certificates:
.br .RS
The certificates from this file are matched only against the received .IP Host
server certificate itself; CA certificates are \fBnot\fR supported here. These certificates are matched only against the received server certificate
Do \fBnot\fR specify the system's CA certificate store here; see itself.
\fBSystemCertificates\fR instead. They are always trusted, regardless of validity.
.br A typical use case would be forcing acceptance of an expired certificate.
The contents for this file may be obtained using the .br
\fBmbsync-get-cert\fR tool; make sure to verify the fingerprints of the These certificates may be obtained using the \fBmbsync-get-cert\fR tool;
certificates before trusting them, or transfer them securely from the make sure to verify their fingerprints before trusting them, or transfer
server's network (if it is trusted). them securely from the server's network (if it can be trusted beyond the
server itself).
.IP CA
These certificates are used as trust anchors when building the certificate
chain for the received server certificate.
They are used to supplant or supersede the system's trust store, depending
on the \fBSystemCertificates\fR setting;
it is not necessary and not recommended to specify the system's trust store
itself here.
The trust chains are fully validated.
.RE
. .
.TP .TP
\fBClientCertificate\fR \fIpath\fR \fBClientCertificate\fR \fIpath\fR

Loading…
Cancel
Save