GitLocker: The Coding Marketplace

Description:

djangoauthenticationservice 0.0.2

Authentication Service Backend

A django rest authentication service backend that handles storage of users account and authentication of their identities.
Endpoints
Here are it's key features:

Register
Login (JWT)
Login (Refresh JWT)
Request Email
Verify Email (Uid & Token)
Logout
Change Password
Reset Password
Reset Password Complete
Suspend User

API Schema
Download and Import the schema to your favourite API testing tool (postman, insomnia, etc) to get the endpoints and expected payload.
Requirements

Python (3.8, 3.9.*)
Django (2.2, 3.0, 3.1, 3.2, 4.*)

Quick Start
1). Install using pip:
pip install django-authentication-service

2). Add authentication_service to your INSTALLED_APPS setting:
INSTALLED_APPS = [
...
"authentication_service",
]

Make sure that you have djangorestframework, djangorestframework-simplejwt and drf-yasg installed in your apps.
INSTALLED_APPS = [
# django installed apps
...
# already added to installed_apps
"rest_framework",
"rest_framework.authtoken",
"rest_framework_simplejwt",

# this will help document the apis using either swagger or redoc
"drf_yasg",

# new line
"authentication_service",
]

3). Configure the AUTH_USER_MODEL in the setting:
AUTH_USER_MODEL = "authentication_service.AccountUser"

4). Register the account user model to the admin; if you don't want to - set it to False:
REGISTER_USER_MODEL = True # this will show the user model on the django admin

5). In order to use the pre-built email templates, you'd have to include the name of your site (or product name) and the contact email:
AUTHENTICATION_SERVICE = {
"site_name": "Authentication Service",
"contact_email": "contact@authentication-service.com"
}

6). Include the authentication_service URLs in your project urls.py:
path('auth/', include('authentication_service.urls')),

7). Run python manage.py migrate to create new migrations based on the changes on the model.
8). Start the development server:
python manage.py runserver 8080

Documentation & Support
If you find a code smell, or bad practice(s) anywhere while exploring through the codebase - kindly create an issue stating what it is; or fix the code smell, bad practice or whatever it is you found. As the saying goes, multiple heads are better than one. winks
License
Disclaimer: Everything you see here is open and free to use as long as you comply with the license. There are no hidden charges. We promise to do our best to fix bugs and improve the code quality.