Metadata-Version: 2.0
Name: django-auth-oidc
Version: 0.1.0
Summary: OpenID Connect authentication support for Django
Home-page: https://github.com/LEW21/django-auth-oidc
Author: Linus Lewandowski
Author-email: linus@lew21.net
License: LGPLv2+
Keywords: django,auth,oauth,openid,oidc,social,ldap
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: System Administrators
Classifier: Natural Language :: English
Classifier: License :: OSI Approved :: GNU Lesser General Public License v2 or later (LGPLv2+)
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: System :: Systems Administration :: Authentication/Directory
Requires-Dist: django (>=1.10.0)
Requires-Dist: python-jose

Django-Auth-OIDC - OpenID Connect authentication support for Django
=========================================================================
.. image:: https://badge.fury.io/py/django-auth-oidc.svg
    :target: https://badge.fury.io/py/django-auth-oidc

This is a Django login view that authenticates against an OpenID Connect
Authentication Server.

Use it if you own a single Authentication Server that you want to share
between multiple apps.

What is OpenID Connect?
-----------------------

It's a OAuth2-based standard for authentication in applications.

It can be used for social logins (but python-social-auth_ is much better
for this case), and for setting up Single Sign-On into multiple services
hosted by the same company. In the last case, it somewhat supersedes LDAP,
as with OIDC people are entering their credentials only into the views
served by the Authentication Server, and not into all the company's
applications.

Requirements
------------

- Python 3.6+. **Python 2 is not supported, and won’t ever get supported.**
- Django 1.10+
- python-jose_

Installation
------------

.. code:: python

    pip install django-auth-oidc

settings.py
~~~~~~~~~~~

.. code:: python

    INSTALLED_APPS += ['django_auth_oidc']

urls.py
~~~~~~~

.. code:: python

    urlpatterns += [
        url(r'^accounts/login/', include('django_auth_oidc.urls')),
    ]

Configuration
-------------

Authorization Server
~~~~~~~~~~~~~~~~~~~~

App's redirect URI: http(s)://app-domain/accounts/login/callback

App's environment variables
~~~~~~~~~~~~~~~~~~~~~~~~~~~

* OIDC_SERVER - OpenID Connect Authorization Server URL.
* OIDC_CLIENT_ID - Client ID received from the Authorization Server
* OIDC_CLIENT_SECRET - Client secret received from the Authorization Server

.. _python-jose: https://github.com/mpdavis/python-jose
.. _python-social-auth: https://github.com/omab/python-social-auth


