diff --git a/sysadm/user-management/how-to-manage-creds-store.rst b/sysadm/user-management/how-to-manage-creds-store.rst index c34dcbc..ee894bf 100644 --- a/sysadm/user-management/how-to-manage-creds-store.rst +++ b/sysadm/user-management/how-to-manage-creds-store.rst @@ -1,9 +1,44 @@ .. _how_to_manage_creds_store: 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 +^^^^^^^^^^ + +The repository location is `in the forge +`_. + +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 +`_.