Skip to main content

A Django app that provides authentication, password change, password reset and account verification functionalities.

Project description

“django-auth-essentials” is a Django app that provides all the basic and necessary authentication and account verification functionalities you need for your django project, out of the bat. Once successfully integrated to your project, you don’t need to worry about register, login/logout, password change/reset functionalities as “django-auth-essentials” takes care of those. “django-auth-essentials” also provides email/account verification options to make your life easier.

Detailed documentation is in the “docs” directory.

Quick start

  1. Add django_auth_essentials to your INSTALLED_APPS setting like this:

  2. Include the django_auth_essentials URLconf in your project like this:

    path('accounts/', include('django_auth_essentials.urls')),
  3. Start the development server python runserver.

  4. Visit to test it yourself.


With above steps, you’ve successfully integrated “django_auth_essentials” to your project. But there is more you can do with “django_auth_essentials”. It comes with several different configuration options. You can configure it as per your project requirements.

The initial integration already provides register, login/logout and password changing functionalities. Below are some extra and handy configurations for “django_auth_essentials”.

User Email Configurations

REQUIRE_EMAIL determines whether email is required when registering:

# by default it's set to False (Not required)

UNIQUE_EMAIL determines if registering email should be unique or not:

# by default it's set to False (Not unique)

ALLOW_VERIFICATION determines the integration of email verification feature:

# by default it's set to False (No verification)

NOTE: If you have this setting turned on you don’t need to specify UNIQUE_EMAIL or REQUIRE_EMAIL

Password Reset Configuration

ALLOW_PASSWORD_RESET determines the integration of password resetting feature:

# by default it's set to False (Not integrated)

NOTE: For ALLOW_VERIFICATION and ALLOW_PASSWORD_RESET settings to work, you need to specify email settings for your project. Verification email and password resetting email will utilize those settings. For example:

EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'

# This Configuration is for gmail
EMAIL_HOST_PASSWORD = 'yourpassword'

Access Restricting Configurations

NOTE: If you defined your own access restriction logics, you can avoid these settings completely.

RESTRICT_UNAUTHENTICATED_USER_ACCESS determines if “django_auth_essentials” ‘s default access restriction for unauthenticated users to regitration, login, password reset and email verification pages only should be implemented:

# by default set to False (Not implemented)

LOGIN_REQUIRED_EXEMPT_URLS a List | Let’s you add custom urls you want to be accessible to the unauthenticated users if you have RESTRICT_UNAUTHENTICATED_USER_ACCESS turned on:


UNAUTHENTICATED_SPECIFIC_URLS a List | Let’s you add custom urls you want to be accessible specificly to the unauthenticated users:


NOTE: If you have any dynamic urls you want to include in the LOGIN_REQUIRED_EXEMPT_URLS and/or UNAUTHENTICATED_SPECIFIC_URLS configurations, simply specify the url path leading upto the dynamic part. For example if your dynamic url is something like “dynamic/url/<pk>/” all you need to do is add “dynamic/url/” to the desired setting.

Project details

Release history Release notifications | RSS feed

This version


Download files

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

Source Distribution

django-auth-essentials-1.0.tar.gz (14.3 kB view hashes)

Uploaded Source

Built Distribution

django_auth_essentials-1.0-py3-none-any.whl (21.7 kB view hashes)

Uploaded Python 3

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