privacyIDEA is an open solution for strong two-factor authentication like OTP tokens, SMS, Smartphones or SSH keys. Using privacyIDEA you can enhance your existing applications like local login (PAM, Windows Credential Provider), VPN, remote access, SSH connections, access to web sites or web portals with a second factor during authentication. Thus boosting the security of your existing applications.
privacyIDEA does not bind you to any decision of the authentication protocol or it does not dictate you where your user information should be stored. This is achieved by its totally modular architecture. privacyIDEA is not only open as far as its modular architecture is concerned. But privacyIDEA is completely licensed under the AGPLv3.
It supports a wide variety of authentication devices like OTP tokens (HMAC, HOTP, TOTP, OCRA, mOTP), Yubikey (HOTP, TOTP, AES), Smartphone Apps like Google Authenticator, SMS, Email, SSH keys.
The new version 2.x is based on flask and sqlalchemy as the python backend. The web UI is based on angularJS and bootstrap.
A new MachineToken design lets you assign tokens to machnies. Thus you can use your Yubikey to unlock LUKS. Starting with version 2.2 you can also use offline OTP with PAM.
With version 2 the code was cleaned up and it was emphasized to keep a good code coverage. The design separates the database layer from the library layer and from the REST API layer. Thus allowing easy unit testing in each layer.
You are also welcome to take a look at the hopefully tidy code and contribute.
I try to keep up a good test coverage. So run tests!
You can setup the system in a virtual environment:
git checkout https://github.com/privacyidea/privacyidea.git cd privacyidea virtualenv venv source venv/bin/activate pip install -r requirements.txt
Read the install instructions at http://privacyidea.readthedocs.org.
Create the database:
Create the first administrator:
./pi-manage.py admin add <username> <email>
Now you can connect to http://localhost:5000 with your browser and login as administrator.
Run in virtualenv
For running the server in a virtual env see documentation at http://privacyidea.readthedocs.org/en/latest/installation/index.html#python-package-index.
nosetests -v --with-coverage --cover-package=privacyidea --cover-html
The database models are defined in
models.py and tested in tests/test_db_model.py.
Based on the database models there are the libraries
lib/config.py which is
responsible for basic configuration in the database table
And the library
lib/resolver.py which provides functions for the database
resolver. This is tested in tests/test_lib_resolver.py.
Based on the resolver there is the library
lib/realm.py which provides functions
for the database table
realm. Several resolvers are combined into a realm.
Based on the realm there is the library
lib/user.py which provides functions
for users. There is no database table user, since users are dynamically read from
the user sources like SQL, LDAP, SCIM or flat files.
The database model has changed, so that you need to upgrade the database.
!! Before upgrading be sure to make a backup !!
To upgrade your database from 1.5 to the new 2.0 schema run:
./manage db upgrade