django-windowsauth

Easy integration and deployment of Django projects into Windows Environments.

Documentation is available at https://django-windowsauth.readthedocs.io/en/latest/

PyPI Package at https://pypi.org/project/django-windowsauth/

Django Packages at https://djangopackages.org/packages/p/django-windowsauth/

Requirements:

• Python (3.6, 3.7, 3.8, 3.9)
• Django (2.2, 3.1, 3.2)

Features

• Deploy to Microsoft IIS quickly using wfastcgi
• Authenticate via IIS's Windows Authentication.
• Authorize against Active Directory using ldap3 package
• Manage LDAP Connections for easy integrations
• Debug using django-debug-toolbar
• NEW Create Task Schedulers for Django management commands

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

INSTALLED_APPS = [
    "windows_auth",
]

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

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

If you don't need Windows Authentication on your site, skip adding the middleware and authentication backend.

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 may use the GitHub Disccussion.

For any bug or issue, open a new GitHub Issue.

Contributing