This commit is contained in:
Markus Unterwaditzer 2014-05-25 17:54:09 +02:00
parent 5a89f9c66b
commit 306cee4946

View file

@ -22,17 +22,18 @@ System Keyring
*vdirsyncer* can also use your system's password storage for saving password in *vdirsyncer* can also use your system's password storage for saving password in
a (more) secure way. a (more) secure way.
To use it, you must install To use it, you must install keyring_.
[keyring](https://bitbucket.org/kang/python-keyring-lib).
.. _keyring: https://bitbucket.org/kang/python-keyring-lib
*vdirsyncer* will use the full resource URL as the key when saving. *vdirsyncer* will use the full resource URL as the key when saving.
When retrieving the key, it will try to remove segments of the URL's path until When retrieving the key, it will try to remove segments of the URL's path until
it finds a password. For example, if you save a password under the key it finds a password. For example, if you save a password under the key
`vdirsyncer:http://example.com`, it will be used as a fallback for all ``vdirsyncer:http://example.com``, it will be used as a fallback for all
resources on `example.com`. If you additionally save a password under the key resources on ``example.com``. If you additionally save a password under the key
`vdirsyncer:http://example.com/special/`, that password will be used for all ``vdirsyncer:http://example.com/special/``, that password will be used for all
resources on `example.com` whose path starts with `/special/`. resources on ``example.com`` whose path starts with ``/special/``.
*keyring* support these keyrings: *keyring* support these keyrings: