Skip to main content

Providers for django-allauth allowing using the ENS' auth-systems.

Project description

This package is meant to ease the management of authentication of django-apps at the ENS.

On top of django-allauth, which provides easy ways to configure the authentication of django-apps, this package provides:

  • social authentication using Clipper (cas.eleves);
  • ready-to-use templates in replacement of allauth’ ones;
  • helpers to use allauth’s login and logout views instead of those provided by third-parties (Django admin, wagtail, etc).



First, install django-allauth.

Then, install django-allauth-ens:

$ pip install django-allauth-ens

And edit your settings file:

    # …

    # Above allauth to replace its templates.

    # Added when you installed allauth.

    # Required to use CAS-based providers (e.g. Clipper).

    # …


See also the allauth configuration and advanced usage docs pages.


Optional — A view name or an url path.

Used as a link from the templates of allauth_ens to return to your application.

Examples: 'home', '/home/'


Optional — A view name or an url path.

Used as a link from the templates of allauth_ens for a logged in user to access their profile in your app.

Examples: 'my-account', '/my-account/'


Optional — Boolean (default: True).

When set to True, displays prominently the Clipper option in the login view (if you use the allauth_ens templates).


Capture other login and logout views

You can use the capture_login and capture_logout views to replace the login and logout views of other applications. They redirect to their similar allauth’s view and forward the query string, so that if a GET parameter next is given along the initial request, user is redirected to this url on successful login and logout.

This requires to add urls before the include of the app’ urls.

For example, to replace the Django admin login and logout views with allauth’s ones:

from allauth_ens.views import capture_login, capture_logout

urlpatterns = [
    # …

    # Add it before include of admin urls.
    url(r'^admin/login/$', capture_login),
    url(r'^admin/logout/$', capture_logout),

    url(r'^admin/$', include(,

    # …


The templates provided by allauth only contains the bare minimum. Hopefully, this package includes ready-to-use templates. They are automatically used if you put 'allauth_ens' before 'allauth' in your INSTALLED_APPS,


Google, Facebook¸ but also Clipper…

To interact with an external authentication service, you must add the corresponding provider application to your INSTALLED_APPS.

allauth already includes several providers (see also their python path). In addition to that, this package adds the following providers:


It uses the CAS server

Add 'allauth_ens.providers.clipper' to the INSTALLED_APPS.

Available settings and their default value:

    # …
    'clipper': {
        # These settings control whether a message containing a link to
        # disconnect from the CAS server is added when users log out.
Populated data
  • username: <clipper>
  • email (primary and verified): <clipper>


Long Term Clipper Adapter

We provide an easy-to-use SocialAccountAdapter to handle the fact that Clipper accounts are not eternal, and that there is no guarantee that the clipper usernames won’t be reused later.

This adapter also handles getting basic information about the user from SPI’s LDAP.

Important: If you are building on top of allauth, take care to preserve the extra_data['ldap'] of SocialAccount instances related to Clipper (where provider_id is clipper or clipper_inactive).

Set SOCIALACCOUNT_ADAPTER='allauth_ens.adapter.LongTermClipperAccountAdapter' in
Populated data
  • username: <clipper>@<entrance year>
  • email: from LDAP’s mailRoutingAddress field, or <clipper>
  • first_name, last_name from LDAP’s cn field
  • entrance_year (as 2-digit string), department_code, department and promotion (department+year) parsed from LDAP’s homeDirectory field
  • extra_data in SocialAccount instance, containing all these field except promotion (and available only on first connection)
Account deprecation
At the beginning of each year (i.e. early November), to prevent clipper username conflicts, you should run $ python deprecate_clippers. Every association clipper username <-> user will then be put on hold, and at the first subsequent connection, a verification of the account will be made (using LDAP), so that a known user keeps his account, but a newcomer won’t inherit an archicube’s.
You can customize the SocialAccountAdapter by inheriting allauth_ens.adapter.LongTermClipperAccountAdapter. You might want to modify get_username(clipper, data) to change the default username format. By default, get_username raises a ValueError when the connexion to the LDAP failed or did not allow to retrieve the user’s entrance year. Overriding get_username (as done in the example website) allows to get rid of that behaviour, and for instance attribute a default entrance year.
Initial migration
If you used allauth without LongTermClipperAccountAdapter, or another CAS interface to log in, you need to update the Users to the new username policy, and (in the second case) to create the SocialAccount instances to link CAS and Users. This can be done easily with $ python install_longterm.

Demo Site

See example/README.


First, you need to clone the repository.


This project uses compass to compile SCSS files to CSS.

Using bundler

  • Ensure Ruby is installed ($ ruby -v) or install Ruby
  • Ensure bundler is installed ($ bundle -v) or install bundler ($ gem install bundler)
  • Install dependencies: $ bundle install
  • Watch changes and recompile: $ bundle exec compass watch


Local environment

  • fakeldap and mock, install with $ pip install mock fakeldap
  • $ ./


  • tox, install with $ pip install tox
  • python{2.7,3.4,3.5,3.6} must be available on your system path
  • all (django/python with combined coverage + flake8 + isort): $ tox


Assuming you use the following settings (when needed):

ACCOUNT_ADAPTER = 'shared.allauth_adapter.AccountAdapter'
SOCIALACCOUNT_ADAPTER = 'shared.allauth_adapter.SocialAccountAdapter'

Signup disabled, except for clipper provider (auto-signup)

In shared/

class AccountAdapter(DefaultAccountAdapter):
    def is_open_for_signup(self, request):
        return False

class SocialAccountAdapter(DefaultSocialAccountAdapter):
    def is_open_for_signup(self, request, sociallogin):
        # sociallogin.account is a SocialAccount instance.
        # See

        if sociallogin.account.provider == 'clipper':
            return True

        # It returns AccountAdapter.is_open_for_signup().
        # See
        return super().is_open_for_signup(request, sociallogin)

Project details

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_allauth_ens-1.1.1-py2.py3-none-any.whl (690.2 kB) Copy SHA256 hash SHA256 Wheel py2.py3
django-allauth-ens-1.1.1.tar.gz (683.2 kB) Copy SHA256 hash SHA256 Source None

Supported by

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