Complete Two-Factor Authentication for Django
Project description
Complete Two-Factor Authentication for Django. Built on top of the one-time password framework django-otp and Django’s built-in authentication framework django.contrib.auth for providing the easiest integration into most Django projects. Inspired by the user experience of Google’s Two-Step Authentication, allowing users to authenticate through call, text messages (SMS), by using a token generator app like Google Authenticator or a YubiKey hardware token generator (optional).
I would love to hear your feedback on this package. If you run into problems, please file an issue on GitHub, or contribute to the project by forking the repository and sending some pull requests. The package is translated into English, Dutch and other languages. Please contribute your own language using Transifex.
Test drive this app through the online example app, hosted by Heroku. It demos most features except the Twilio integration. The example also includes django-user-sessions for providing Django sessions with a foreign key to the user. Although the package is optional, it improves account security control over django.contrib.sessions.
Compatible with all supported Django versions. At the moment of writing that’s including 1.8, 1.9 and 1.10 on Python 2.7, 3.4, 3.5 and 3.6. Documentation is available at readthedocs.org.
Installation
Installation with pip:
$ pip install django-two-factor-auth
Setup
Add the following apps to the INSTALLED_APPS:
INSTALLED_APPS = ( ... 'django_otp', 'django_otp.plugins.otp_static', 'django_otp.plugins.otp_totp', 'two_factor', )
Add django_otp.middleware.OTPMiddleware to MIDDLEWARE_CLASSES. It must be installed after AuthenticationMiddleware:
MIDDLEWARE_CLASSES = [ 'django.middleware.common.CommonMiddleware', 'django.contrib.sessions.middleware.SessionMiddleware', 'django.middleware.csrf.CsrfViewMiddleware', 'django.contrib.auth.middleware.AuthenticationMiddleware', 'django_otp.middleware.OTPMiddleware', 'django.contrib.messages.middleware.MessageMiddleware', ]
Configure a few urls in settings.py:
from django.core.urlresolvers import reverse_lazy LOGIN_URL = 'two_factor:login'
Add the url routes to the project in urls.py:
urlpatterns = [ url(r'', include('two_factor.urls', 'two_factor')), ]
Be sure to remove any other login routes, otherwise the two-factor authentication might be circumvented. The admin interface should be automatically patched to use the new login method.
Support for YubiKey is disabled by default, but enabling is easy. Please refer to the documentation for instructions.
Contribute
Submit issues to the issue tracker on Github.
Fork the source code at Github.
Write some code and make sure it is covered with unit tests.
Send a pull request with your changes.
Provide a translation using Transifex.
Running tests
This project aims for full code-coverage, this means that your code should be well-tested. Also test branches for hardened code. You can run the full test suite with:
make test
Or run a specific test with:
make test TARGET=tests.tests.TwilioGatewayTest
For Python compatibility, tox is used. You can run the full test suite, covering all supported Python and Django version with:
tox
Releasing
The following actions are required to push a new version:
python example/manage.py makemigrations two_factor git commit -am "Added migrations" bumpversion [major|minor|patch] git commit -am "Released version [version]" git tag [version] python setup.py sdist bdist_wheel twine upload dist/*
See Also
Have a look at django-user-sessions for Django sessions with a foreign key to the user. This package is also included in the online example app.
License
The project is licensed under the MIT license.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for django-two-factor-auth-1.5.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 596ca6a8d6f71b1acc2b1aa5cd1d8e13f2ada8bfa5808f2b5aa07922eb2b55c9 |
|
MD5 | 31015012486583446615bf18415b2d44 |
|
BLAKE2b-256 | b015189a595635f54d78bb23fefbc762d572ba5e87a9bc1676200c23420ba9f7 |
Hashes for django_two_factor_auth-1.5.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 91e730cb0984508b97d93e7d7547f7a1676651908982b6c00fa2d10b34cda2f2 |
|
MD5 | 85982549cbf1cb5c52bc886c9c71e871 |
|
BLAKE2b-256 | abd3a3900013553338331b384d412af1135512d875eff904a866e7aeb9eed3bb |