Django social authentication made simple
Pull request Compare This branch is 102 commits behind omab:master.
Latest commit f28b9c9 Jun 26, 2013 @krvss Typo fix
Failed to load latest commit information.
contrib PEP8 Mar 1, 2012
doc Document google-oauth2 offline mode. Refs #712 Jun 15, 2013
example Typo fix Jun 26, 2013
social_auth Fixing VK APP authentication and app page text with new VKAPP_* settings Jun 26, 2013
.gitignore Ignore Nov 15, 2012
COPYRIGHT.django-twitter-oauth Fixed code licence, apps names where incorrect. Updated documentation Nov 9, 2010
ChangeLog Style changelog for docs. Refs #605 Feb 15, 2013
LICENSE Update license Jan 21, 2012
LICENSE.django-openid-auth * renames: LICENCE -> LICENSE, LICENCE.django-openid-auth -> LICENSE… Dec 24, 2011
Makefile add .spec file and Makefile to build RPM package Jan 20, 2012
django-social-auth.spec Add Fedora OpenID login support Apr 30, 2013
requirements.txt added mock to requirements. Jan 23, 2013 Fixed letter case in Apr 13, 2013


Django Social Auth

Django Social Auth is an easy way to setup social authentication/authorization mechanism for Django projects.

Crafted using base code from django-twitter-oauth and django-openid-auth, it implements a common interface to define new authentication providers from third parties.

You can view this app's documentation on Read the Docs too.


This application provides user registration and login using social site credentials. Some features are:


There's a demo at Note: It lacks some backends' support at the moment.


Join the django-social-auth discussion list and bring any questions or suggestions that would improve this application.

Also join the IRC channel #django-social-auth on Freenode server.


Extensive documentation at Read the Docs.


Dependencies that must be met to use the application:


From pypi:

$ pip install django-social-auth


$ easy_install django-social-auth

or clone from github:

$ git clone git://

and add social_auth to PYTHONPATH:

$ export PYTHONPATH=$PYTHONPATH:$(pwd)/django-social-auth/


$ cd django-social-auth
$ sudo python install


If you're having problems with using the project, use the support forum at CodersClan.

Copyrights and Licence

django-social-auth is protected by BSD licence.

Some bits were derived from others' work and copyrighted by:

  • django-twitter-oauth:

    Original Copyright goes to Henrik Lied (henriklied)
    Code borrowed from
  • django-openid-auth:

    django-openid-auth -  OpenID integration for django.contrib.auth
    Copyright (C) 2007 Simon Willison
    Copyright (C) 2008-2010 Canonical Ltd.