Metadata-Version: 2.1
Name: django-windowsauth
Version: 1.1
Summary: Django integration into IIS with Windows Authentication made easy.
Home-page: https://github.com/danyi1212/django-windowsauth
Author: Dan Yishai
Author-email: danyi1212@gmail.com
License: BSD-3-Clause
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Environment :: Win32 (MS Windows)
Classifier: Natural Language :: English
Classifier: Framework :: Django
Classifier: Framework :: Django :: 2.2
Classifier: Framework :: Django :: 3.0
Classifier: Framework :: Django :: 3.1
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Operating System :: Microsoft
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Internet :: WWW/HTTP :: WSGI
Classifier: Topic :: Internet :: WWW/HTTP :: WSGI :: Application
Classifier: Topic :: Internet :: WWW/HTTP :: WSGI :: Middleware
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Systems Administration :: Authentication/Directory
Classifier: Topic :: System :: Systems Administration :: Authentication/Directory :: LDAP
Classifier: Topic :: Documentation
Classifier: Topic :: Documentation :: Sphinx
Requires-Python: >=3.6
Requires-Dist: Django (>=2.2)
Requires-Dist: wfastcgi (>=3.0.0)
Requires-Dist: ldap3 (>=2.8.1)

django-windowsauth
==================

.. comments [![Documentation Status](https://readthedocs.org/projects/django-windowsauth/badge/?version=latest)](https://django-windowsauth.readthedocs.io/en/latest/?badge=latest)

**Easy integration and deployment of Django projects into Windows Environments.**
Documentation is available at https://django-windowsauth.readthedocs.io/en/latest/

Requirements:

- Python (3.6, 3.7, 3.8, 3.9)
- Django (2.2, 3.0, 3.1)

Features
~~~~~~~~
- Deploy to **Microsoft IIS** quickly using `wfastcgi <https://pypi.org/project/wfastcgi/>`_
- Authenticate via `IIS's Windows Authentication <https://docs.microsoft.com/en-us/iis/configuration/system.webserver/security/authentication/windowsauthentication/#:~:text=You%20can%20use%20Windows%20authentication,Windows%20accounts%20to%20identify%20users.&text=When%20you%20install%20and%20enable,the%20default%20protocol%20is%20Kerberos>`_.
- Authorize against **Active Directory** using `ldap3 <https://ldap3.readthedocs.io/en/latest/>`_ package
- Manage **LDAP Connections** for easy integrations
- (Coming soon) Integration with `django-debug-toolbar <https://django-debug-toolbar.readthedocs.io/en/latest/>`_

Quick Start
-----------
1. Install with `pip install django-windowsauth`
2. Run `py manage.py migrate windows_auth`
3. Add "fastcgi application" with `wfastcgi-enable`
4. Configure project settings

.. code-block::  python

    INSTALLED_APPS = [
       "windows_auth",
    ]

    MIDDLEWARE = [
       'django.contrib.auth.middleware.AuthenticationMiddleware',
       'django.contrib.auth.middleware.RemoteUserMiddleware',
    ]

    AUTHENTICATION_BACKENDS = [
       "windows_auth.backends.WindowsAuthBackend",
       "django.contrib.auth.backends.ModelBackend",
    ]

    WAUTH_DOMAINS = {
       "<your domain's NetBIOS Name> (EXAMPLE)": {
           "SERVER": "<domain FQDN> (example.local)",
           "SEARCH_SCOPE": "<search scope> (DC=example,DC=local)",
           "USERNAME": "<bind account username>",
           "PASSWORD": "<bind account password>",
       }
    }

    # optional
    STATIC_URL = '/static/'
    STATIC_ROOT = BASE_DIR / "static"

    MEDIA_URL = '/media/'
    MEDIA_ROOT = BASE_DIR / "media"

5. Generate **web.config** files with `py manage.py createwebconfig -s -m`
6. Create new IIS Website from the project files

For more details visit the docs for installation: https://django-windowsauth.readthedocs.io/en/latest/installation/installation.html

Getting help
------------

In case you have trouble while using this module, you can use

For any bug or issue, see how to create a GitHub Issue

Contributing
------------


