Skip to main content

Email identification authentication app for Django.

Project description

travis codacy coverage pypi

Django’s auth.User model uses a username field to uniquely identify a user. django-simple-authentication uniquely identifies users with an email address instead, removing the username field altogether.

Additionally, django-simple-authentication offers a feature that forces users to change their password the next time they log in. This can be done by setting simple_authentication.User.force_password_change to True. The ForcePasswordChangeMiddleware must be installed for this feature to work properly.


  1. Install: pip install django-simple-authentication.

  2. Add: simple_authentication to INSTALLED_APPS.

  3. Add: AUTH_USER_MODEL = 'simple_authentication'.

  4. Add: simple_authentication.middleware.ForcePasswordChanceMiddleware to MIDDLEWARE.

  5. Make migrations: python makemigrations simple_authentication.

  6. Apply migrations: python migrate simple_authentication.


django_simple_authentication has been tested on Django versions >= 2.0. It may work without issue on earlier versions of Django (or Python), but this is not officially supported.





Improved unit test coverage (up to 76%).


Ensure migrations are excluded from the PyPI distribution.


Initial version.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-simple-authentication-0.1.2.tar.gz (8.4 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page