https://github.com/danyi1212/django-windowsauth

Easy integration and deployment of Django projects into Windows Environments
https://github.com/danyi1212/django-windowsauth

active-directory active-directory-integration django django-auth django-authentication django-authorization iis iis-server ldap ldap-authentication ldap3 python python3 wfastcgi windows

Last synced: about 6 hours ago
JSON representation

Easy integration and deployment of Django projects into Windows Environments

• Host: GitHub
• URL: https://github.com/danyi1212/django-windowsauth
• Owner: danyi1212
• License: bsd-3-clause
• Created: 2020-12-05T17:00:52.000Z (almost 4 years ago)
• Default Branch: main
• Last Pushed: 2023-02-15T20:16:39.000Z (over 1 year ago)
• Last Synced: 2024-10-11T22:24:58.513Z (about 1 month ago)
• Topics: active-directory, active-directory-integration, django, django-auth, django-authentication, django-authorization, iis, iis-server, ldap, ldap-authentication, ldap3, python, python3, wfastcgi, windows
• Language: Python
• Homepage: https://django-windowsauth.readthedocs.io/en/latest/
• Size: 820 KB
• Stars: 27
• Watchers: 2
• Forks: 3
• Open Issues: 8
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE

Awesome Lists containing this project

README

        
django-windowsauth

==================

.. image:: https://readthedocs.org/projects/django-windowsauth/badge/?version=latest

    :target: https://django-windowsauth.readthedocs.io/en/latest/?badge=latest

    :alt: Documentation Status

    

.. image:: https://img.shields.io/badge/Maintained-yes-green.svg

    :target: https://github.com/danyi1212/django-windowsauth/graphs/commit-activity

    :alt: Maintained

   

.. image:: https://static.pepy.tech/personalized-badge/django-windowsauth?period=total&units=international_system&left_color=grey&right_color=blue&left_text=Downloads&service=github

    :target: https://pepy.tech/project/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

.. code-block::  python

    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 = {

        " (EXAMPLE)": {

            "SERVER": " (example.local)",

            "SEARCH_SCOPE": " (DC=example,DC=local)",

            "USERNAME": "",

            "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

------------