skip to navigation
skip to content

django-social-auth 0.7.24

Django social authentication made simple.

Latest Version: 0.7.28

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.

.. contents:: Table of Contents


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

- Registration and login with social sites using the following providers
at the moment:

* `Google OpenID`_
* `Google OAuth`_
* `Google OAuth2`_
* `Yahoo OpenID`_
* OpenId_ like myOpenID_
* `Twitter OAuth`_
* `Facebook OAuth`_

Some contributions added support for:

* `DISQUS OAuth`_
* `LiveJournal OpenID`_
* `Orkut OAuth`_
* `Linkedin OAuth`_
* `Foursquare OAuth2`_
* `GitHub OAuth`_
* `Dropbox OAuth`_
* `Flickr OAuth`_
* `Vkontakte OAuth`_
* `MSN Live Connect OAuth2`_
* `Skyrock OAuth`_
* `Yahoo OAuth`_
* `Evernote OAuth`_
* ` OAuth`_
* `Odnoklassniki OAuth`_
* `Mixcloud OAuth2`_
* `BitBucket OAuth`_
* `Douban OAuth`_
* `Fitbit OAuth`_
* `Instagram OAuth2`_
* `Twilio`_
* `Trello OAuth`_
* `Weibo OAuth2`_
* `Yandex OpenId`_
* `Shopify OAuth2`_
* `StockTwits OAuth2`_
* `Stackoverflow OAuth2`_
* `Fedora OpenID`_
* `Exacttarget HubExchange`_
* `Appsfuel OAuth2`_

- Basic user data population and signaling to allows custom fields values
from providers' responses

- Multiple social account associations to a single user

- Custom User model override if needed (`auth.User`_ by default)

- Extensible pipeline to handle authentication/association mechanism


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:

- OpenId_ support depends on python-openid_

- OAuth_ support depends on python-oauth2_

- Several backends demands application registration on their corresponding


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.

.. image::
:width: 100px
:height: 100px
:scale: 10

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.

.. _django-twitter-oauth:
.. _django-openid-auth:
.. _Read the Docs:
.. _Google OpenID:
.. _Google OAuth:
.. _Google OAuth2:
.. _Yahoo OpenID:
.. _OpenId:
.. _myOpenID:
.. _Twitter OAuth:
.. _Facebook OAuth:
.. _DISQUS OAuth:
.. _LiveJournal OpenID:
.. _Orkut OAuth:
.. _Linkedin OAuth:
.. _Foursquare OAuth2:
.. _GitHub OAuth:
.. _Dropbox OAuth:
.. _Flickr OAuth:
.. _Vkontakte OAuth:
.. _MSN Live Connect OAuth2:
.. _Skyrock OAuth:
.. _Yahoo OAuth:
.. _Evernote OAuth:
.. OAuth:
.. _Odnoklassniki OAuth:
.. _Mixcloud OAuth2:
.. _BitBucket OAuth:
.. _Douban OAuth:
.. _Fitbit OAuth:
.. _Instagram OAuth2:
.. _Twilio:
.. _Trello:
.. _Weibo OAuth2:
.. _Yandex OpenId:
.. _Shopify OAuth2:
.. _StockTwits OAuth2:
.. _auth.User:
.. _python-openid:
.. _python-oauth2:
.. _OAuth:
.. _pypi:
.. _github:
.. _django-social-auth discussion list:!forum/django-social-auth
.. _Stackoverflow OAuth2:
.. _Fedora OpenID:
.. _Exacttarget HubExchange:
.. _Appsfuel OAuth2:  
File Type Py Version Uploaded on Size
django-social-auth-0.7.24.tar.gz (md5) Source 2013-07-16 79KB