PuttyAgent plugin for KeePass by Nikolaus Hammler

INTRODUCTION
============

The PuttyAgent plugin adds SSH agent support to KeePass. It is derived
from PuTTY's Pageant.

The plugin works as follows: Just attach any *.ppk file to a password
entry. In case that the ppk-file is password-protected, add the password
to the password field. The key is first tried without a password and
afterwards with the password from the password field.

All *.ppk files found within KeePass are automatically served by the
plugin while the workspace is not locked. When locking the database,
all loaded keys are discarded.

The key list is updated when opening the database or unlocking the
workspace or after saving the database. Thus you have to save the database
first for the changes to take effect after removing/adding key files
to KeePass.

The current list of served keys can be viewed through

  Extras -> PuttyAgent -> Show Keys

When there is a signing request while the database is locked, the plugin
tries to unlock the workspace first.

Please note that there can only be one agent running at the same time.
Therefore it is not possible to use this plugin and pageant.exe at the
same time.

ADVANCED USAGE
==============

The plugin can be controlled by an external program by using the agent
protocol. It is possible to list, add or remove keys by an external
application.

Most notably, the original pageant.exe can be used to load additional
keys to the plugin:

  pageant.exe new-key.ppk

However, currently these keys are discarded when key update occurs,
that is, when locking workspace, closing or saving the database file.

Currently I only need keys within KeePass therefore I did not implement
advanced features. If you do, please drop me a mail. If I have time I
may add functionality.

INSTALL
=======

Just copy the files to the program directory of KeePass and restart KeePass.

HISTORY
=======

v1.0:
- Initial release


Niki Hammler,
niki@hammler.net
niki.hammler.net