Skip to main content

A custom user-model based package with features ranging from JWT and Basic authentication to REST API end-points for signup, signin, email verification, password resetting and account activation.

Project description

Welcome to django-rest-xauth

Build Status Coverage Status Codacy Badge Documentation Status PyPI version PyPI - Python Version

A custom user model based django-package to implement a secure and easily customizable JWT and Basic authentication in 5 simple steps for django project(s). It provides JSON formatted REST API end-points for signup, signin, email verification, password resetting and account activation.

Email verification and password resetting are based on hashed verification-code and temporary password respectively. Account activation is based on a combination of user selected security question(provided through the admin portal by site administrator(superuser)) and an answer.

What makes django-rest-xauth different

  • Custom user class provides some common optional fields with reasonable complementary helper methods. For example, date_of_birth field that also comes with an age calculation helper method
  • Access logging(IP-address should be provided as a X-Forwarded-For header)
  • Failed Sign-in attempts logging(IP-address should be provided as a X-Forwarded-For header)
  • Password-reset logging(IP-address should be provided as a X-Forwarded-For header)
  • Encrypted JWT tokens
  • Security question based account activation in-case account was deactivated
  • Temporary password based user password reset
  • Verification code based user account activation.

N/B: temporary passwords and verification codes are both generated and returned from the User model hence opting to SMS based sending of the verification codes and temporary passwords should be as easy as extending the User model, overriding a single method(that also generates and returns the code) and finally changing django's AUTH_USER_MODEL to your model name as explained here.

Quick start

  • Install package pip install django-rest-xauth

Modify your Django project's settings.py file

  • Add xauth to your INSTALLED_APPS setting like this
INSTALLED_APPS = [
    ...,
    'xauth',
    'rest_framework',
]
  • Add/modify your AUTH_USER_MODEL setting to
# Can also be a (modified) direct subclass of `xauth.models.AbstractUser`
AUTH_USER_MODEL = 'xauth.User'
  • Add/modify your REST_FRAMEWORK setting to
REST_FRAMEWORK = {
    'DEFAULT_AUTHENTICATION_CLASSES': [
        'xauth.authentication.BasicTokenAuthentication',
        ...,
    ],
    'EXCEPTION_HANDLER': 'xauth.utils.exceptions.exception_handler',
}
  • Include the xauth URLconf in your project urls.py like this
urlpatterns = [
    path('accounts/', include('xauth.urls', namespace='xauth')),
    ...,
]
  • Run python manage.py migrate to create the xauth models.
  • Run python manage.py createsuperuser to create a superuser account.
  • Run python manage.py runserver to start the development server.
  • Visit http://127.0.0.1:8000/accounts/signup/ to register a new account.

API endpoints

Read more here.

Documentation and support

Full documentation for the project is available here.

Contributing

Please be sure to review contributing guidelines to learn how to help the project.

Postman Team

Join postman team.

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-rest-xauth-1.0.8.tar.gz (39.4 kB view hashes)

Uploaded Source

Built Distribution

django_rest_xauth-1.0.8-py3-none-any.whl (41.6 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