Metadata-Version: 2.0
Name: django-auth-gitlab
Version: 0.1.0
Summary: OpenID Connect authentication support for Django
Home-page: https://github.com/LEW21/django-auth-gitlab
Author: Linus Lewandowski
Author-email: linus@lew21.net
License: LGPLv2+
Keywords: django,auth,oauth,openid,oidc,social,gitlab
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)

Django-Auth-GitLab - GitLab authentication support for Django
=============================================================
.. image:: https://badge.fury.io/py/django-auth-gitlab.svg
    :target: https://badge.fury.io/py/django-auth-gitlab

This is a Django login view that authenticates against GitLab.

Use it if you own a single GitLab instance that you want to use as
a OAuth Authentication Server between multiple apps.

See also django-auth-oidc_.

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

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

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

.. code:: python

    pip install django-auth-gitlab

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

.. code:: python

    INSTALLED_APPS += ['django_auth_gitlab']

urls.py
~~~~~~~

.. code:: python

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

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

GitLab
~~~~~~

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

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

* GITLAB_SERVER - Gitlab Server URL - with trailing slash.
* GITLAB_CLIENT_ID - Client ID received from GitLab
* GITLAB_CLIENT_SECRET - Client secret received from GitLab

.. _django-auth-oidc: https://github.com/LEW21/django-auth-oidc


