sjs/vdirsyncer
1
0
Fork 0
mirror of https://github.com/samsonjs/vdirsyncer.git synced 2026-04-26 14:47:44 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Some clarifications

Browse source
This commit is contained in:
Markus Unterwaditzer 2015-01-06 13:54:46 +01:00
parent 3d62c19f42
commit f76aeba9bc
1 changed files with 5 additions and 5 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

10
docs/tutorial.rst
View file

@ -154,14 +154,14 @@ Vdirsyncer uses the requests_ library for all its HTTP and SSL interaction.
All SSL configuration is done per-storage. Storages that have anything to do All SSL configuration is done per-storage. Storages that have anything to do
with SSL have two parameters: ``verify`` and ``verify_fingerprint``. with SSL have two parameters: ``verify`` and ``verify_fingerprint``.
- The ``verify`` parameter determines whether to verify SSL certificates - The ``verify`` parameter determines whether to verify SSL certificates.
against a set of trusted root CAs or PEM certificates.
1. The default, ``true``, means that certificates will be validated against 1. The default, ``true``, means that certificates will be validated against
`requests' own set of root CAs `requests' own set of root CAs
<http://www.python-requests.org/en/latest/user/advanced/#ca-certificates>`_. <http://www.python-requests.org/en/latest/user/advanced/#ca-certificates>`_.
2. The value ``false`` will disable any validation. Unless combined with 2. The value ``false`` will disable both trusted-CA-validation and the
validation of the certificate's expiration date. Unless combined with
``verify_fingerprint``, you should not use this value at all. ``verify_fingerprint``, you should not use this value at all.
3. You can also set ``verify`` to a path of the server's certificate in PEM 3. You can also set ``verify`` to a path of the server's certificate in PEM
@ -170,7 +170,7 @@ with SSL have two parameters: ``verify`` and ``verify_fingerprint``.
[storage foo] [storage foo]
type = caldav type = caldav
... ...
verify = /path/to/cert.pem verify = "/path/to/cert.pem"
- The ``verify_fingerprint`` parameter can be used to *additionally* compare - The ``verify_fingerprint`` parameter can be used to *additionally* compare
the SSL fingerprint to a fixed value. The value can be either a the SSL fingerprint to a fixed value. The value can be either a
@ -183,6 +183,6 @@ with SSL have two parameters: ``verify`` and ``verify_fingerprint``.
Using it will *not* turn off the normal CA validation. If you use a Using it will *not* turn off the normal CA validation. If you use a
self-signed certificate which you want to pin down, you have to also set self-signed certificate which you want to pin down, you have to also set
``verify = False``. ``verify = false``.
.. _requests: www.python-requests.org/ .. _requests: www.python-requests.org/