django-otp

This project makes it easy to add support for one-time passwords (OTPs) to Django. It can be integrated at various levels, depending on how much customization is required. It integrates with django.contrib.auth, although it is not a Django authentication backend. The primary target is developers wishing to incorporate OTPs into their Django projects as a form of two-factor authentication.

This project includes several simple OTP plugins and more are available separately. This package also includes an implementation of OATH HOTP and TOTP for convenience, as these are standard OTP algorithms used by multiple plugins.

This version is supported on Python 2.6, 2.7, 3.2, 3.3, and 3.4; and Django >= 1.4.2.

• Overview and Key Concepts
  • Installation
  • Authentication and Verification
  • Plugins and Devices
    • Built-in Plugins
    • Other Plugins
  • Settings
  • Glossary
• Authentication and Authorization
  • Authenticating Users
    • The Easy Way
    • The Authentication Form
    • The Admin Site
    • The Token Form
    • The Low-Level API
  • Authorizing Users
  • Managing Devices
• Extending Django-OTP
  • Writing a Device
  • Utilities
    • django_otp.oath
    • django_otp.util
• Change Log
  • v0.2.7 - April 26, 2014 - Fix for Custom user models with South
  • v0.2.6 - April 18, 2014 - Fix for Python 3.2 with South
  • v0.2.4 - April 15, 2014 - TOTP plugin fix (migration warning)
  • v0.2.3 - March 3, 2014 - Fix pickling
  • v0.2.2 - December 31, 2013 - Require Django 1.4.2
  • v0.2.1 - November 19, 2013 - Bug fix
  • v0.2.0 - November 10, 2013 - Django 1.6
  • v0.1.8 - August 20, 2013 - user_has_device API
  • v0.1.7 - July 3, 2013 - Decorator improvement
  • v0.1.6 - May 9, 2013 - Unit test improvements
  • v0.1.5 - May 8, 2013 - OTPAdminSite improvement
  • v0.1.3 - March 10, 2013 - Django 1.5 compatibility
  • v0.1.2 - October 8, 2012 - Bug fix
  • v0.1.0 - August 20, 2012 - Initial Release

License

Copyright (c) 2012, Peter Sagerson All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

• Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
• Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS “AS IS” AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.