Skip to main content

Django sessions with a foreign key to the user

Project description

Build Status Test Coverage PyPI

Django includes excellent built-in sessions, however all the data is hidden away into base64 encoded data. This makes it very difficult to run a query on all active sessions for a particular user. django-user-sessions fixes this and makes session objects a first class citizen like other ORM objects.

Also, have a look at the online example app, hosted by Heroku. It also contains the package django-two-factor-auth, but that application is not a dependency for this package. Also have a look at the bundled example templates and views to see how you can integrate the application into your project.

Compatible with Django 1.4, 1.5, 1.6 and 1.7 on Python 2.6, 2.7, 3.2, 3.3 and 3.4. Documentation is available at readthedocs.org.

Features

To get the list of a user’s sessions:

user.session_set.filter(expire_date__gt=now())

Or logout the user everywhere:

user.session_set.all().delete()

The user’s IP address and user agent are also stored on the session. This allows to show a list of active sessions to the user in the admin:

http://i.imgur.com/YV9Nx3f.png

And also in a custom layout:

http://i.imgur.com/d7kZtr9.png

Installation

  1. pip install django-user-sessions

  2. In INSTALLED_APPS replace 'django.contrib.sessions' with 'user_sessions'.

  3. In MIDDLEWARE_CLASSES replace 'django.contrib.sessions.middleware.SessionMiddleware' with 'user_sessions.middleware.SessionMiddleware'.

  4. Add SESSION_ENGINE = 'user_sessions.backends.db'.

  5. Add url(r'', include('user_sessions.urls', 'user_sessions')), to your urls.py.

  6. Run python manage.py syncdb (or migrate) and browse to /account/sessions/.

GeoIP

You need to setup GeoIP for the location detection to work. See the Django documentation on installing GeoIP.

Contribute

  • Fork the repository on GitHub and start hacking.

  • Run the tests.

  • Send a pull request with your changes.

  • Provide a translation using Transifex.

License

This project is licensed under the MIT license.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-user-sessions-1.1.0.tar.gz (17.6 kB view details)

Uploaded Source

Built Distribution

django_user_sessions-1.1.0-py2.py3-none-any.whl (34.4 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file django-user-sessions-1.1.0.tar.gz.

File metadata

File hashes

Hashes for django-user-sessions-1.1.0.tar.gz
Algorithm Hash digest
SHA256 f96024e40a260652cd90885a5d87831faeaee3972ee93fe70f5625ff57c974e1
MD5 6f4e0cca845907059ca273928b96ab57
BLAKE2b-256 274ace15734561d1f14daf111bf75834a68ae198143509e7b1627b70f3daab7e

See more details on using hashes here.

File details

Details for the file django_user_sessions-1.1.0-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for django_user_sessions-1.1.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 153b704a69d205141517ad3dc4f7d99104c9675df4435ca6cae733d14a3b578c
MD5 8be392ec7a9d9dea6dd88556e6ed7f7a
BLAKE2b-256 0247e9491a0f9aa64dd5a0f73b51a976b2a1ed4a07f3ac0965e82bc4ce1f4447

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page