Metadata-Version: 1.1
Name: django-auth-adfs
Version: 0.0.1
Summary: A Django authentication backend for Microsoft ADFS
Home-page: https://github.com/jobec/django-auth-adfs
Author: Joris Beckers
Author-email: joris.beckers@gmail.com
License: BSD
Download-URL: https://pypi.python.org/pypi/django-auth-adfs
Description: ADFS Authentication for Django
        ==============================
        
        .. image:: https://readthedocs.org/projects/django-auth-adfs/badge/?version=latest
            :target: http://django-auth-adfs.readthedocs.org/en/latest/?badge=latest
            :alt: Documentation Status
        .. image:: https://img.shields.io/pypi/v/django-auth-adfs.svg
            :target: https://pypi.python.org/pypi/django-auth-adfs
        .. image:: https://travis-ci.org/jobec/django-auth-adfs.svg?branch=master
            :target: https://travis-ci.org/jobec/django-auth-adfs
        .. image:: https://codecov.io/github/jobec/django-auth-adfs/coverage.svg?branch=master
            :target: https://codecov.io/github/jobec/django-auth-adfs?branch=master
        
        A Django authentication backend for Microsoft ADFS
        
        * Free software: BSD License
        * Homepage: https://github.com/jobec/django-auth-adfs
        * Documentation: http://django-auth-adfs.readthedocs.org/
        
        Features
        --------
        
        * Let's your django users login through Microsoft ADFS by using OAuth2.
        * Provides seamless single sign-on on intranet environments.
        * Automatically creates users upon receiving a valid access token from ADFS.
        * Adds users to groups upon signin
        
        Installation
        ------------
        
        Python package::
        
            pip install django-auth-adfs
        
        In your project's ``settings.py``
        
        .. code-block:: python
        
            AUTHENTICATION_BACKENDS = (
                ...
                'django_auth_adfs.backend.AdfsBackend',
                ...
            )
        
            INSTALLED_APPS = (
                ...
                # Needed for the redirect URL to function
                'django_auth_adfs',
                ...
        
            AUTH_ADFS = {
                "ADFS_SERVER": "adfs.yourcompany.com",
                "ADFS_CLIENT_ID": "your-configured-client-id",
                "ADFS_RESOURCE": "your-adfs-RPT-name",
                "ADFS_SIGNING_CERT": "/path/to/adfs-signing-certificate.pem",
                "ADFS_AUDIENCE": "microsoft:identityserver:your-adfs-RPT-name",
                "ADFS_ISSUER": "http://adfs.yourcompany.com/adfs/services/trust",
                "ADFS_CA_BUNDLE": "/path/to/ca-bundle.pem",
                "ADFS_CLAIM_MAPPING": {"first_name": "given_name",
                                       "last_name": "family_name",
                                       "email": "email"},
            }
        
        In your project's ``urls.py``
        
        .. code-block:: python
        
            urlpatterns = [
                ...
                # Needed for the redirect URL to function
                url(r'^oauth2/', include('django_auth_adfs.urls', namespace='auth_adfs')),
                ...
            ]
        
        The URL you have to configure as the redirect URL in ADFS depends on the url pattern you configure.
        In the example above you have to make the redirect url in ADFS point to ``https://yoursite.com/oauth2/login``
        
        Contributing
        ------------
        Contributions to the code are more then welcome.
        For more details have a look at the ``CONTRIBUTION.rst`` file.
        
        
        
Keywords: django authentication adfs oauth2
Platform: UNKNOWN
Classifier: Environment :: Web Environment
Classifier: Framework :: Django :: 1.8
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Internet :: WWW/HTTP :: WSGI
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Development Status :: 3 - Alpha
