User Documentation
Understand the concepts
PPassKeeper is meant to give you full control on how to save sentive data. To do so, PPassKeeper accepts modules that can be added at any time, without needing any recompilation of the library or the software using it. In order to understand how to use software using ppasskeeper, you only have to understand the key concept, module's concept.
What is a module ?
A module is a way data can be stored. For instance, there are modules for KWallet, Window's registry, Files, etc ...
Modules have different storage security, that's why it is important to know how secure they are to chose the one that suits you most.
Modules Feature Matrix
| Module Name | Read/Write ? | Supports Listing ? | Supports Strings | Supports Blobs | Security | Description |
| SaveToFile?_PT | X | X | X | X | highly unsecured | Save the password to a file in plain text file. |
| SaveToregistry? | X | X | X | X | highly unsecured | Save the password to Windows's Registry. |
| SaveToFile?_Enc | X | X | X | X | unsecured | Save the password to a file in scrambled text file. |
| GKeyring | X | X | X | X | fairly good | Store the password into the Gnome Keyring. |
| KWallet4 | X | X | X | X | fairly good | Store the password into the KDE 4 Wallet. |
| MacOSX_Keychain | WIP | WIP | WIP | WIP | fairly good | Store the password into the Mac OS X Keychain. |
| AskForPass?_Qt | X | almost perfect | Ask for the password through a Qt Window. | |||
| AskForPass?_GTK | X | almost perfect | Ask for the password through a GTK Window.! | |||
| AskForPass?_Win32 | X | almost perfect | Ask for the password through a Win32 Window. |
Legend :
- WIP = Work In Progress
- X = Already done
How to use the given utils
PPassKeeper is not really meant to be used directly by users, but, as there are two pieces of software directly runnable, we are creating a small documentation for them :
- Man page of ppasskeeper
- No documentation for ppasskeeper-qt? yet.
How to lock the library
With the release of PPassKeeper beta 2, a new feature appeared. You can now lock the library to avoid people to sneak into your passwords stored on non-secured locations.
To avoid this security to be overcame, you should first set your master password by using the Qt ppasskeeper utils for instance. Then, I advise you to change the owner of the file to root so as no-one can delete the file and access the library again.
