Swekey Hardware Authentication plugin for SquirrelMail
===============================
Ver 1.0.7, 12/29/08

Original authors: Musbe, Inc. <info@musbe.com>


Description
===========
The swekey is an USB authentication key.
If you use this plugin, swekey owners will be able to secure their squirrelmail
access using hardware authentication.
It means that a swekey owner won't be abble to login if its swekey is not
plugged to its computer. 

How it works
============

This plugin adds a little key logo at the right of the 'username' input box of 
the login form. When the key is gray it means that there is no swekey plugged, 
if it turns green a swekey is detected.

The first time a user will plug its swekey in its computer while he his logged 
an alert will popup asking him to attach the plugged swekey to his account.

If the user confirms, the swekey is then attached to the account.

Once a swekey is attached to an account the following features will be available:

    * When your swekey is plugged the login dialog will automatically fill the 'username' input box.
    * You won't be able to login without the swekey plugged.
    * If you unplug your swekey while you are logged, you are automatically logged out.
    * You can detach the swekey from your account in your profile.

You can purchase a swekey at:
	http://store.swekey.com/index.php?promo=squirrelmail

License
=======

This plugin is released under the GNU General Public
License (see the file COPYING for details).



Donations
=========

For each purchased swekey using the above URL $1 will be donated
to the SquirrelMail project.


Requirements
============

  * SquirrelMail version 1.2.9 or above
  * Compatibility plugin version 2.0.7 or above, unless
    using SquirrelMail 1.5.2+ or 1.4.10+



Help Requests
=============

Before looking for help elsewhere, please try to help yourself:

  * Look to support pages here:
    http://www.swekey.com

  * If you cannot find any information about your issue, please
    email support@swekey.com



Notice
======

Even if the administrator has set SM to store user preferences in a database, the
table that maps swekey ids to users is stored in files in the SM data directory.


Change Log
==========

  1.0.7   12/29/08  Musbe, Inc. <info@musbe.com>
   * The option panel show the "disable swekey" option even the very first time.
   * Artwork is no longer fetched from the swekey web site (generated a warning with IE using https)   
  1.0.6   12/16/08  Musbe, Inc. <info@musbe.com>
   * Fixed minor bugs
  1.0.5   12/16/08  Musbe, Inc. <info@musbe.com>
   * Swekey logo is no longer retreived from swekey web site
  1.0.4   11/08/08  Musbe, Inc. <info@musbe.com>
   * Full support for sqm 1-5-2
  1.0.0  11/08/08  Musbe, Inc. <info@musbe.com>
   * Initial release



