Soft-Yubikey Emulation Extension
--------------------------------

A software based Yubikey Gnome Shell extension for Yubicos
OTP Authentication.

Installation
------------

Copy the tarball to $HOME/.local/share/gnome-shell/extensions
and unpack it. A directory called softyubikey@yubiserver.include.gr
should be created.

Edit the yubisoft.cfg file in the softyubikey@yubiserver.include.gr
directory and set the values to Public ID, Private ID and AES Key for
your software emulated Yubikey. Please do not touch any other value.
Initialize your new Yubikey account to your Yubikey Validation Server.

An example of the values is given below

aeskey = 2777d70a7888beab1040aeb24d71b3fg
privateid = c68b7c593c25
publicid = ccdnttfcebk


Copy ykey python executable to /usr/bin and ensure that you have all appropriate 
Python packages for the script to run. 

python-xlib
python-crypto
python-opensll

Ensure that the script has the write (755) permissions.
If you want to test your extension by not invoking the Gnome Shell key you can 
execute the command below:

$ python ykey '\n'

Restart your GNOME shell (Alt-F2 r or by any other way) and enable your extension using
gnome-tweak-tool or by any other method.

If the extension does not install, check the version number in metadata.json.
You may have to change it to work with your particular version of the GNOME Shell.
If not please check the error messages via Looking Glass.

Version
-------

V1.0 11/02/2012 Initial release for GNOME Shell 3.2

Notes
-----

This version of the extension does NOT work on versions of the GNOME Shell < 3.2.

This has only been tested on Fedora 16, Debian Wheezy and GNOME Shell 3.2.

As of the date of the latest version of this extension, there are no officially 
published APIs for the GNOME Shell. This extension relies on an internal structures 
which may or may not be present in future versions of the GNOME Shell.

Misc
----

For the latest version of my GNOME Shell extension please do not hesitate to contact me or
check my website http://www.include.gr

To report errors or issues:

	nanakos@wired-net.gr
