Yubico Authenticator for Desktop (Windows, macOS and Linux) and Android
Go to file
David Woodhouse f07f8501a4 Fix non-ASCII password compatibility with pre-KitKit Android
The PBKDF2 function in Android used to use only the low 8 bits of each
character. So if we have a non-ASCII (well, non-ISO8859-1) password and
it doesn't work, try mangling it the same way.

See http://forum.yubico.com/viewtopic.php?f=26&t=1601#p6807 for details.
2015-02-05 11:29:35 +00:00
scripts added man 2014-05-08 11:11:52 +02:00
yubicoauthenticator Fix non-ASCII password compatibility with pre-KitKit Android 2015-02-05 11:29:35 +00:00
.gitignore initial release 2014-02-18 14:02:47 +01:00
BLURB Clarify license. Closes #11. 2014-05-04 10:16:01 +02:00
COPYING initial release 2014-02-18 14:02:47 +01:00
MANIFEST.in minor fix 2014-04-02 10:05:28 +02:00
NEWS NEWS 2014-04-25 11:02:05 +02:00
README minor 2014-09-09 14:44:50 +02:00
release.py release & news 2014-03-05 01:33:59 -08:00
setup.py Clarify license. Closes #11. 2014-05-04 10:16:01 +02:00

Yubico Authenticator
====================

The Yubico Authenticator is a graphical desktop tool for generating
Open AuTHentication (OATH) event-based HOTP and time-based TOTP
one-time password codes, with the help of a Yubikey NEO that protects
the shared secrets.

License
-------

Yubico Authenticator is licensed under GPLv3+, see COPYING for
details.

Dependencies
------------

To build the Yubico Authenticator you need the following Python
modules: PySide, PBKDF2, pyscard.  To use it, you need a YubiKey NEO
with the OATH applet loaded.

Building Windows binaries
-------------------------

For Windows you will need python, PySide, PyInstaller and Pywin32
installed (32 or 64-bit versions depending on the architecture of the
binary your are building).

Clone the git repository and checkout the desired release tag (or
branch):

  git clone https://github.com/Yubico/yubioath-desktop.git
  cd yubico-authenticator

To sign the executable, copy the pfx file to yubicoauth.pfx and place
it in the root of the project folder. You will need signtool.exe (from
the Windows SDK) either copied into the root as well or in a location
in your PATH.

Run "pyinstaller.exe -w -i yubico.ico yubicoauthenticator.spec" from
the main project folder.


Building Mac OSX binaries
-------------------------

Install PyInstaller via pip

Run "pyinstaller -w -i "yubioath-48.png" yubicoauthenticator.spec" 
from the main project folder.

Codesign the code with:
codesign -s 'Developer ID Application' /path/to/directory/project.app --deep

Build the package with:
http://s.sudre.free.fr/Software/Packages/about.html


Running from Linux / OSX
------------------------

Install Python 2.7.x
	
	cd yubicoauthenticator/
	Run "python yubico_authenticator.py --help"
	Run "python yubico_authenticator.py"

The application will start and sit on the system's systray.

On Ubuntu 14.04 you need the following packages first.
	
	sudo apt-get install pcscd python-pyscard python-pbkdf2 python-pyside.qtgui


No systray mode
--------------

For users without a systrabar or running desktop envinronment with non standard Qt behaviour

	cd yubicoauthenticator/
	Run "python yubico_authenticator.py --disable-systray"



ToDo
----

* .deb packaging