Skip to content

Latest commit

 

History

History
45 lines (28 loc) · 1.27 KB

README.md

File metadata and controls

45 lines (28 loc) · 1.27 KB

django-twilio-tfa

Pluggable module for Two factor authentication using Twilio Authy

===== Django Two Factor Authentication

Django TFA is a simple Django app to add two factor authentication to your Django projects super quickly! It's as simple as adding a decorator your views!

Detailed documentation is in the "docs" directory.

Installation

The installer package is available under django-tfa/dist/

Example:

pip install django-tfa-0.1.1.tar.gz

Quick start

  1. Add "django_twilio_tfa" to your INSTALLED_APPS setting like this::

    INSTALLED_APPS = [ ... 'django_twilio_tfa', ]

  2. Include the polls URLconf in your project urls.py like this::

    url(r'^tfa/', include('django_twilio_tfa.urls')),

  3. Add "AUTHY_API_KEY" to settings.py

  4. Add "USER_PROFILE_MODEL" to your settings.py. The "USER_PROFILE_MODEL" should have a one-to-one field with the User model.

  5. The following fields should be available on the USER_PROFILE_MODEL defined above. To edit the field names add the following to settings.py: a. USER_UID_FIELD: Defaults to "uid" - This field should be writable. b. USER_EMAIL_FIELD: Defaults to "email" c. USER_PHONE_FIELD: Defaults to "phone" d. USER_CC_FIELD: Defaults to "country_code"