diff --git a/sysadm/user-management/how-to-manage-creds-store.rst b/sysadm/user-management/how-to-manage-creds-store.rst --- a/sysadm/user-management/how-to-manage-creds-store.rst +++ b/sysadm/user-management/how-to-manage-creds-store.rst @@ -3,7 +3,40 @@ How to manage the credentials store =================================== -.. todo:: - This page is a work in progress. For now, please refer to the `existing documentation - `_. +.. admonition:: Intended audience + :class: important + Staff members + +We use `pass `_, lightweight directory-based password +manager, as our password manager. + +Repository +---------- + +https://forge.softwareheritage.org/source/credentials/ + +Configuration +^^^^^^^^^^^^^ + +A ``git diff`` driver is available: it will allow you to run diff/show +commands on encrypted files transparently. Its configuration is stored +in the ``.gitconfig`` and ``.gitattributes`` file in the repo. To enable +it you should configure your local copy to read ``.gitconfig`` from the +repository, as it is not done by default for security reasons. + +The following will both clone your repo and set it up to use the diff +driver: + +:: + + git clone ssh://git@forge.softwareheritage.org/diffusion/PWD/credentials.git + git config --local include.path ../.gitconfig + +(yes, it's really ``../``, because the path is relative to the ``.git/`` +directory) + +Information +^^^^^^^^^^^ + +More information can be found at `the repository `_.