django-discord-oauth2 0.2.0

Django application for secure user authorisation using Discord OAuth2

django-discord-oauth2

[!WARNING] App under development!!

Installation

pip install django-discord-oauth2

Usage

1. Add django_discord_oauth2 to your INSTALLED_APPS setting like this:

   INSTALLED_APPS = [
       'django_discord_oauth2',
   ]
   

2. Include the django_discord_oauth2 URLconf in your project urls.py like this:

   from django.urls import include, path
   
   urlpatterns = [
       path('oauth2/', include('django_discord_oauth2.urls')),
   ]
   

3. Run python manage.py migrate to create the necessary models.

4. Add your Discord application credentials to your settings:

   DISCORD_CLIENT_ID = 'your_client_id'
   DISCORD_CLIENT_SECRET = 'your_client_secret'
   DISCORD_REDIRECT_URI = 'your_redirect_uri'
   

How to get these variables?

1. Visit Discord Developer Portal.
2. Create a new application or use an existing one.
3. Open the OAuth2 section in the left panel:

5. Copy the CLIENT ID:

7. This is your DISCORD_CLIENT_ID.
8. Press the "Reset Secret" button and copy the token:

10. This is your DISCORD_CLIENT_SECRET.
11. Add a redirect URL, for example:

5. Start the development server and visit http://127.0.0.1:8000/oauth2/login/ to initiate the login process.