README.rst

Django Authentication Logger

This is a modest Django app that contains how thelab likes to log authentication for staff users. It may be useful to others, but could easily just be copied.

Install

First, install the package from PyPI.

pip install django-auth-logger

Then, add auth_logger to your Django project's INSTALLED_APPS setting.

INSTALLED_APPS = [
    ...
    'auth_logger',
    ...
]

Usage

By default both successful and failed log-ins are logged to standard Python logging (at INFO level).

In the future we may decide to add more configuration options.

Contribution

The scope of this project is small and specific - but we welcome adding configuration settings to change behavior and meet more use cases. All configuration options should have a test to verify it works.

If we do add said configuration it will probably look something like this:

AUTH_LOGGER = {
    'LOG_ONLY_STAFF': True
}

Changelog

2.2.0

• Support django-ipware v4

2.1.0

• Add Django 3.2 to test suite

2.0.0

• Update to django-ipware v3

1.1.1

• Update test suite for with Django 2.2 and Python 3.8

1.1.0

• Log all login attempts, instead of just logins for staff users.
• Fix bug which prevented failed login attempts from being correctly logged.

1.0.1

• Add support for Django 2.0.

1.0.0

• Initial release.