django-federated-login 0.3.0

Installation

Installation with pip:

$ pip install django-federated-login

Add 'federated_login.auth_backend.EmailBackend' as authentication backend:

settings.py:
AUTHENTICATION_BACKENDS = (
    'federated_login.auth_backends.EmailBackend',
    'django.contrib.auth.backends.ModelBackend',
)

Provide the Google Apps domain to identify against:

settings.py:
FL_APPS_DOMAIN = 'webatoom.nl'

Register the views:

urls.py:
url(r'^federated/', include('federated_login.urls')),

Usage

Point your browser to /federated/login/. You might want to include a button to this url on the regular login page. You could also use the federated login page as the default login page, replacing the username and password login pages. To do this, configure the LOGIN_ settings:

settings.py:
LOGIN_REDIRECT_URL = '/'
LOGIN_URL = '/federated/login/'

Settings

These are the customizable settings:

FL_APPS_DOMAIN

Google Apps domain to identify against. Can be overriden by FL_SSO_ENDPOINT.

FL_USER_FACTORY (Default: 'federated_login.user_factories.normal')

Function that is called when creating a user account. Set to None to disable creation of new users. There is also ''federated_login.user_factories.normal' that creates superusers.

FL_SSO_ENDPOINT (Default: Google Apps)

Override this setting to link with another OpenID identity provider. The FL_APPS_DOMAIN setting will have no effect when providing a custom FL_SSO_ENDPOINT.

FL_USER_CLASS (Default: 'django.contrib.auth.models.User')

Django model class to used to create and query for users.