mirror of
https://github.com/samsonjs/vdirsyncer.git
synced 2026-03-25 08:55:50 +00:00
74 lines
1.8 KiB
ReStructuredText
74 lines
1.8 KiB
ReStructuredText
=================
|
|
Storing passwords
|
|
=================
|
|
|
|
.. versionchanged:: 0.7.0
|
|
|
|
Password configuration got completely overhauled.
|
|
|
|
Vdirsyncer can fetch passwords from several sources other than the config file.
|
|
|
|
Command
|
|
=======
|
|
|
|
Say you have the following configuration::
|
|
|
|
[storage foo]
|
|
type = "caldav"
|
|
url = ...
|
|
username = "foo"
|
|
password = "bar"
|
|
|
|
But it bugs you that the password is stored in cleartext in the config file.
|
|
You can do this::
|
|
|
|
[storage foo]
|
|
type = "caldav"
|
|
url = ...
|
|
username = "foo"
|
|
password.fetch = ["command", "~/get-password.sh", "more", "args"]
|
|
|
|
You can fetch the username as well::
|
|
|
|
[storage foo]
|
|
type = "caldav"
|
|
url = ...
|
|
username.fetch = ["command", "~/get-username.sh"]
|
|
password.fetch = ["command", "~/get-password.sh"]
|
|
|
|
Or really any kind of parameter in a storage section.
|
|
|
|
With pass_ for example, you might find yourself writing something like this in
|
|
your configuration file::
|
|
|
|
password.fetch = ["command", "pass", "caldav"]
|
|
|
|
.. _pass: https://www.passwordstore.org/
|
|
|
|
Accessing the system keyring
|
|
----------------------------
|
|
|
|
As shown above, you can use the ``command`` strategy to fetch your credentials
|
|
from arbitrary sources. A very common usecase is to fetch your password from
|
|
the system keyring.
|
|
|
|
The keyring_ Python package contains a command-line utility for fetching
|
|
passwords from the OS's password store. Installation::
|
|
|
|
pip install keyring
|
|
|
|
Basic usage::
|
|
|
|
password.fetch = ["command", "keyring", "get", "example.com", "foouser"]
|
|
|
|
.. _keyring: https://github.com/jaraco/keyring/
|
|
|
|
Password Prompt
|
|
===============
|
|
|
|
You can also simply prompt for the password::
|
|
|
|
[storage foo]
|
|
type = "caldav"
|
|
username = "myusername"
|
|
password.fetch = ["prompt", "Password for CalDAV"]
|