Metadata-Version: 2.4
Name: django-jauth
Version: 3.7.2
Summary: Collection of small utilities for Django and Django REST framework projects.
Author-email: Jani Kajala <kajala@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/kajala/django-jauth
Project-URL: Issues, https://github.com/kajala/django-jauth/issues
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: Django>=3.1.0
Requires-Dist: django-extensions>=2.1.9
Requires-Dist: pytz>=2019.1
Requires-Dist: djangorestframework>=3.12
Requires-Dist: requests>=2.22.0
Dynamic: license-file

django-jauth
============

Simple OAuth2 authentication client library for Django and Django REST framework projects. 
Django 3.0+ support. Unit test coverage 51%.


Features
========

* Supports simple integration both to single page apps (via postMessage) and traditional Django apps (via redirect)

* Does not require any JavaScript libraries

This is by no means comprehensive OAuth2 package but simple and serves single purpose.

## Supported / Tested OAuth2 Providers

* Facebook

* Google

## Other Features

* Supports deauthorize and delete Facebook callbacks
 

Configuration
=============

settings.JAUTH_AUTHENTICATION_SUCCESS_REDIRECT:

* Set this as URL of user home page after login. Set as None for single-page apps which open separate dialog for login (Value None causes postMessage to be called for the parent window with authentication result)

settings.JAUTH_AUTHENTICATION_ERROR_REDIRECT:

* Set this as URL of login page with querystring parameter "error" as error message. Can be None for single page apps.


Install
=======

* pip install django-jauth

