CheckPasswordBox Files

CheckPasswordBox
================
http://sourceforge.net/projects/checkpasswordbox


This is a plugin to KeePass <http://www.KeePass.info> to add protection against accidental
auto-typing of passwords into the wrong places.

Compatibility
-------------
CheckPasswordBox is currently only compatible with Windows, as it uses the UIA accessibility
framework.

Most password boxes can be detected, but as it relies on the destination application correctly
reporting whether a box is a password box or not, it can not be 100% accurate. However, it
does fail safely: if it cannot determine that a box is a password box, it will assume it is not.


Installation
------------
Place CheckPasswordBox.plgx in your KeePass Plugins folder.


Usage
-----
To use this plugin, the auto-type sequence must include the placeholder {PASSWORDBOX}. At the
point in the sequence that this placeholder occurs, a check will be made to see if the current
focused control is a password box, and if it is not, auto-typing will stop at that point.

If, when an auto-type is performed, the focus is already in a password box, then the part of
the sequence that comes before the first {PASSWORDBOX} placeholder will be skipped.

The most common sequence should therefore be:

{Username}{Tab}{PasswordBox}{Password}{Enter}

The effect of this will be that if you start with the username box focused, it will type the
username, tab, then check if the password field box focused. If it is not, it will stop there.
Otherwise, it will then type the password and Enter.

If you start with the password box focused, it will skip the username and type only the
password and Enter.

Another useful sequence might be:

{PasswordBox}{Password}

This will autotype only the password, and only if the focus is in a password box.

To change the default auto-type sequence in KeePass, right click on a group (or the root
database group at the top level) and choose Edit Group. The default auto-type sequence for
entries in that group can then be edited on the Auto-Type tab.


Uninstallation
--------------
Delete CheckPasswordBox.plgx from your KeePass Plugins folder. You must also remove any
{PASSWORDBOX} placeholders from auto-type sequences in your database, as these will no longer
be recognized by KeePass


Checking for updates
--------------------
If you want to use the KeePass Check for Updates function to check for updates to this plugin
then it requires the SourceForgeUpdateChecker plugin to be installed too:
http://sourceforge.net/projects/kpsfupdatechecker


Bug Reporting, Questions, Comments, Feedback, Donations
-------------------------------------------------------
Please use the SourceForge project page: <http://sourceforge.net/projects/checkpasswordbox>
Bugs can be reported using the issue tracker, for anything else, a discussion forum is available.


Changelog
---------
v0.1
 Initial release
v0.2
 More robust password box Checking
 Removed unintentional dependency on .NET framework 3.5