README

   1 Password Manager Daemon is a server that provides a way for applications to
   2 securely store and retrieve data at a centralized location. The data is stored
   3 in an XML file and clients connect and send commands to manipulate the data.
   4
   5 I needed this because I use a few applications that require the same
   6 credentials but hate having to update all those configuration files to reflect
   7 any changes. The data file can be edited once with a pwmd client and patched
   8 applications can retrieve the updated info.
   9
  10 Some of the features include:
  11
  12     * Multi-threaded. More than one client may access the data at the same
  13       time.
  14     * Optionally uses the GnuPG Agent for key caching and smartcard support.
  15     * Remote network connctions via libpwmd over GnuTLS or SSH via a proxy.
  16     * Configuration file which supports file specific settings including:
  17       cache expiration and encryption key or key file and more.
  18     * Logging to file and/or syslog.
  19     * Secure memory usage. PWMD will zero out memory before freeing it and
  20       also has the option to lock the entire process in RAM to avoid swapping
  21       the data to virtual memory.
  22
  23
  24 Requirements:
  25 -------------
  26     C99 compiler - http://www.gnu.org/software/gcc
  27                    Has been tested to work. Others should work fine, too.
  28
  29     libassuan    - ftp://ftp.gnupg.org/gcrypt/libassuan
  30                    Protocol. Version 2.0.2 or later is required. Version
  31                    2.1.0 or later is recommended for UDS peer credential
  32                    checking on OS's other than Linux.
  33
  34     libgpg-error - http://www.gnupg.org
  35                    Error handling. Required.
  36
  37     gpg-agent    - http://www.gnupg.org
  38                    Keypair generation, decryption and caching. Version 2.1.0
  39                    or later is required when --use-agent is specified.
  40                    Optional.
  41
  42     pinentry     - http://www.gnupg.org
  43                    Required for passphrase retrieval from either gpg-agent or
  44                    pwmd itself.
  45
  46     libxml2      - http://xmlsoft.org
  47                    Required for XML parsing and data manipulation.
  48
  49     libgcrypt    - http://www.gnupg.org
  50                    Encryption and hashing. Version 1.5.0 or later is required.
  51
  52     libz         - http://www.zlib.net
  53                    For data file conversion. Version 1.2.2.1 or later is
  54                    required.
  55
  56     libgnutls    - http://www.gnu.org/software/gnutls/
  57                    For encrypted connections over a TCP network. Optional.
  58
  59     libacl       - ftp://acl.bestbits.at
  60                    To retain an ACL for a data file. Optional.
  61
  62
  63 Installation:
  64 -------------
  65 ./configure && make install
  66
  67 Typing 'pwmd' will start the server and wait for connections to
  68 ~/.pwmd/socket. Be sure gpg-agent is running (see manual) when
  69 --use-agent is specfied on the pwmd command line (--enable-agent must
  70 be passed to configure at compile-time to enable gpg-agent
  71 support). Passing --allow-preset-passphrase to gpg-agent is
  72 recommended and gpg-agent option --allow-loopback-pinentry is required
  73 if using a keyfile or connecting over TLS.
  74
  75
  76 Connecting:
  77 -----------
  78 Any program that can connect to a UNIX domain socket will work although using
  79 pwmc, a client included with libpwmd, is recommended:
  80
  81     echo command | pwmc filename
  82 or interactively
  83     pwmc filename
  84 or
  85     socat UNIX-CONNECT:$HOME/.pwmd/socket -
  86
  87 A more user-friendly client QPwmc is also available. It has a Qt GUI and is
  88 much easier to use. See http://qpwmc.sourceforge.net/ for details.
  89
  90 Please read pwmd.info manual for protocol commands, syntax and
  91 configuration details. A HTML version is also available in doc/pwmd.html.
  92
  93
  94 GIT Repository
  95 --------------
  96 There is a public GIT repository available at repo.or.cz. Anonymous checkouts
  97 can be done by:
  98
  99     git clone git://repo.or.cz/pwmd.git
 100
 101 The gitweb interface can be viewed at http://repo.or.cz/w/pwmd.git.
 102
 103
 104 Mailing lists
 105 -------------
 106 Please send bug reports, questions or feature requests to
 107 https://lists.sourceforge.net/lists/listinfo/pwmd-users
 108
 109 The same for libpwmd may be sent to
 110 https://lists.sourceforge.net/lists/listinfo/libpwmd-users
 111
 112
 113 Ben Kibbey <bjk@luxsci.net>
 114 XMPP: bjk@jabber.org
 115 http://pwmd.sourceforge.net/