Skip to main content

Timeout a logged user after a period of time

Project description

# django-session-idle-timeout

A Django middleware application to timeout a logged in user
session after a specified time period.
A django message will be issued if the session gets timed out.

## Requirements

Make sure the following Django apps and middlewares are enabled:
* Authentication (http://docs.djangoproject.com/en/dev/topics/auth/)
* Sessions (http://docs.djangoproject.com/en/dev/topics/http/sessions/)
* Messages framework (http://docs.djangoproject.com/en/dev/ref/contrib/messages/)

```python
INSTALLED_APPS += (
'django.contrib.auth',
'django.contrib.sessions',
'django.contrib.messages',
)
```

```python
MIDDLEWARE_CLASSES += (
'django.contrib.auth.middleware.AuthenticationMiddleware',
'django.contrib.sessions.middleware.SessionMiddleware',
'django.contrib.messages.middleware.MessageMiddleware',
)
```

## Installation instructions

Install django-session-idle-timeout
```bash
easy_install django-session-idle-timeout
```

or

```bash
pip install django-session-idle-timeout
```

### Installed apps

```python
INSTALLED_APPS += (
'django-session-idle-timeout',
)
```

### Middleware

```python
MIDDLEWARE_CLASSES += (
'django-session-idle-timeout.middleware.SessionIdleTimeout',
)
```

### Settings

SESSION_IDLE_TIMEOUT defines the period after which the session gets timed out in seconds.
The default value is 30min.

```python
SESSION_IDLE_TIMEOUT = 1800
```

## Keepalive Ping

Keeps the session alive as long as the browser window is opened using a javascript ping.

### Urls

Add to your urls.py e.g.:
```python
urlpatterns += (
url(r'^django-session-idle-timeout/', include('django-session-idle-timeout.urls')),
)
```

### Template

Load the keepalive template tag to start the javascript polling:
```django
{% session_keep_alive %}
{% load session_keep_alive %}
```

## Important
This is a fork of http://github.com/subhranath/django-session-idle-timeout

Project details


Release history Release notifications

This version
History Node

1.4.2

History Node

1.4.0

History Node

1.3.1

History Node

1.3.0

History Node

1.2.0

History Node

1.1.5

History Node

1.0.1

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
django-session-idle-timeout-1.4.2.tar.gz (3.5 kB) Copy SHA256 hash SHA256 Source None Jul 16, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page