/django-mfa-demo

This django application demonstrates how multifactor authentication can be implemented in django application using qr code generators and qr code scanners such as google authenticator

Primary LanguagePythonMIT LicenseMIT

Django Multi-Factor Authentication(Django MFA) APP

By Peter Polle

Description

This is a web application that demonstrates multi-factor authentication with django

Prerequisites

The following are needed for the application to run on a local computer:

  • python version 3.6
  • Django framework
  • Bootstrap v.3
  • Text editor (atom, VS code or sublime text)
  • Web browser
  • Django qr-code generator package
  • Django otp package A crucial point to note: You will need Python version 3 and above installed on your laptop. If you don't have it installed got to Python.org to install.

Getting Started

  • Clone this repository to your local computer and install all the extensions listed in the requirements.txt file.
  • Ensure you have python3.6 installed in your computer.
  • From the terminal navigate to the cloned project folder.
  • Switch to the virtual environment by entering source virtual/bin/activate from the terminal.
  • Once inside the application, a user will be able to use the application.

Running the tests

To run the tests, run python manage.py test auth_app

Deployment

To run local server run python manage.py runserver

License

This project is licensed under the MIT License - see the LICENSE.md file for details