Skip to content

hapytex/django-single-session

Repository files navigation

Django-single-session

PyPi version Documentation Status PyPi license Code style: black

A Django app that enforces that a user has only one active session: if the user logs in on another browser/device, then the previous sessions will log out.

The app will also add an extra action to the ModelAdmin of the user model (if there is such ModelAdmin), that will alow to log out all sessions of a given (set of) user(s).

Installation

The package can be fetched as django-single-session, so for example with pip with:

pip3 install django-single-session

One can install the app by adding the single_session app to the INSTALLED_APPS setting:

# settings.py

# ...

INSTALLED_APPS = [
    # ...,
    'django.contrib.sessions',
    # ...,
    'single_session'
    # ...
]

MIDDLEWARE = [
    # ...,
    'django.contrib.sessions.middleware.SessionMiddleware',
    # ...,
    'django.contrib.auth.middleware.AuthenticationMiddleware',
    # ...
]

SESSION_ENGINE = 'django.contrib.sessions.backends.db'

For the SESSION_ENGINE setting, the database backend, django.contrib.sessions.backends.db should be used, since that is the one where the item is linking to.

In order to work properly, the SessionMiddleware and AuthenticationMiddleware will be necessary, or another middleware class that will add a .session and .user attribute on the request object and will trigger the user_logged_in and user_logged_out signals with the proper session and user.

and running migrate to migrate the database properly:

python3 manage.py migrate single_session

This will by default enforce that a user will only have one logged in session. This will not proactively logout existing sessions: only if the user logs in with another browser or device, the old session(s) will be closed.

Configuration

One can disable the single session behavior by setting SINGLE_USER_SESSION in settings.py to False (or any other value with truthiness False).

You can customise this behaviour by making the SINGLE_USER_SESSION setting be a string representing the name of a function which takes a user object as an argument. If this function returns True then the user will be logged out. If it returns False then the user will not be logged out.

The tool will also clean up all sessions of a user in case that user logs out. This thus means that if a user logs out on one browser/device, they will log out on all other browsers/devices as well. This functionality is still enabled if SINGLE_USER_SESSION is set to False. You can disable this by setting the LOGOUT_ALL_SESSIONS setting in settings.py to False (or any other value with truthiness False).

Logging out (other) users

If there is a ModelAdmin for the user model (if you use the default user model, then there is such ModelAdmin), and the django.contrib.admin package is installed, then that ModelAdmin will have extra actions to log out normal users and admin users.

You can thus select users, and log these out with the "Log out the user on all sessions" action. This will invalidate all the sessions for (all) the selected user(s). In order to do this, the single_session.logout permission is required, so only admin users and users with such permission can log out other users. Users with such permission can log out users, but not admin users.

There is an extra permission named single_session.logout_all to log out all users, including admin users. Users with such permission can thus also log out admin users, so it might be better not to give such permission to all (staff) users.

Contributors

  • @alastair implemented a system such that one can add a string that points to a callback for the SINGLE_USER_SESSION setting, to make it possible to determine what users should be logged out.