https://github.com/cnobile2012/django-pam

A Django PAM Authentication Backend implementation.
https://github.com/cnobile2012/django-pam

django django-application pam-authentication python

Last synced: about 1 month ago
JSON representation

A Django PAM Authentication Backend implementation.

• Host: GitHub
• URL: https://github.com/cnobile2012/django-pam
• Owner: cnobile2012
• License: mit
• Created: 2016-03-30T00:29:53.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2023-10-02T23:52:27.000Z (about 1 year ago)
• Last Synced: 2024-10-01T18:08:13.401Z (about 2 months ago)
• Topics: django, django-application, pam-authentication, python
• Language: Python
• Size: 600 KB
• Stars: 13
• Watchers: 4
• Forks: 7
• Open Issues: 4
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
==========

Django PAM

==========

.. image:: http://img.shields.io/pypi/v/django-pam.svg

   :target: https://pypi.python.org/pypi/django-pam

   :alt: PyPI Version

.. image:: http://img.shields.io/pypi/wheel/django-pam.svg

   :target: https://pypi.python.org/pypi/django-pam

   :alt: PyPI Wheel

.. image:: http://img.shields.io/pypi/pyversions/django-pam.svg

   :target: https://pypi.python.org/pypi/django-pam

   :alt: Python Versions

.. image:: http://img.shields.io/pypi/l/django-pam.svg

   :target: https://pypi.python.org/pypi/django-pam

   :alt: License

A Django PAM authentication backend implementation.

The MIT License (MIT)

Overview

--------

This is a simple authentication backend that uses the

`python-pam `_

package. Django PAM can be used in an SSO (Single Sign On) environment

or just with a single box where you want to log into a Django app with

your UNIX login.

Updated for Django 4.2.x and Python 3.11.

Python 2.x has been depricated. If you need a version of Django PAM use

version 2.0.1.

Provides

--------

1. PAM Authentication Backend

2. Login and Logout Views

3. Templates for both standard and modal authentication.

4. Supporting JavaScript and CSS.

Quick Start

-----------

You will need to add Django PAM to your ``INSTALLED_APPS``::

  INSTALLED_APPS = [

      ...

      'django_pam',

  ]

Next you will need to add the Django PAM backend to the ``AUTHENTICATION_BACKENDS``::

  AUTHENTICATION_BACKENDS = [

      'django_pam.auth.backends.PAMBackend',

      'django.contrib.auth.backends.ModelBackend',

  ]

The user that runs the application needs to be a member of the

``/etc/shadow`` file group, this is usually the web server user. This

is necessary so the web server can authenticate other users. To do

this run the command below with the proper user::

  $ sudo usermod -a -G shadow 

Complete Documentation can be found on

`Read the Docs `_ at:

`Django PAM `_