django-windowsauth 1.4.0

Easy integration and deployment of Django projects into Windows Environments.

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.0, 3.1)

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

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