Cerberos documentation

Cerberos is a django app that watches failed logins and block the user after N attempts.

When a user have tried to login a certain number of times, cerberos blocks the login view to the user.

Installation

Intallation is very simple:

After that, add 'cerberos' to INSTALLED_APPS

and run the migrations

Usage

To enable cerberos the login view must be decorated with cerberos.decorators.watch_logins.

Example:

When the user is locked, it renders the template cerberos/user-locked.html. You can override the template to show the users the information you want.

These parameters are passed to the template:

  • ip: The ip address of the user locked
  • failed_access: The FailedAccessAttempt instance

Settings

MAX_FAILED_LOGINS: The maximum number of failed logins before blocking the user.

MEMORY_FOR_FAILED_LOGINS: The number in seconds after the failed access attemps will be forgotten. If set to 0, the attempts won’t be forgotten. Default = 0

CONTRIBUTE

Cerberos is hosted at github: https://github.com/AdrianRibao/cerberos

Feel free to send us your comments, ideas and pull request.

Project Versions

Table Of Contents

This Page