Imap authentification backend for Django
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
imapauth first commit Jan 11, 2013
.gitignore first commit Jan 11, 2013
LICENSE first commit Jan 11, 2013 first commit Jan 11, 2013 upd readme Jan 11, 2013 first commit Jan 11, 2013

=============== django-imapauth

django-imapauth is a simple IMAP authentification backend for django.

Quick start

Requirements :

  • Django 1.4.3 (tested).
  1. Install the app

    pypi version

    pip install django-imapauth

    development version

    pip install -e git+
  2. Add 'imapauth.backends.IMAPBackend' to your AUTHENTICATION_BACKENDS setting

  3. Add IMAPAUTH_HOST in your settings

    IMAPAUTH_HOST = 'my_imap_host'


With django-imapauth, when a user try to authenticate in your system, the IMAPBackend will try to connect to the IMAPAUTH_HOST with his credentials. Be careful, it's not because a user is authenticated that he can access the admin site. For that, refer to the example below, and use CustomIMAPBackend in AUTHENTICATION_BACKENDS:

from imapauth.backends import IMAPBackend

class CustomIMAPBackend(IMAPBackend):
    def authenticate(self, username=None, password=None):
        user = super(CustomIMAPBackend, self).authenticate(username, password)
        if user is None:
            return None
        user.is_staff = True
        return user

Further information

IMAPBackend copied from