django-social-auth 0.7.9

Django social authentication made simple.

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.

Table of Contents

• Demo

• Features

• Documentation

• Dependencies

• Installation

• Copyrights and Licence

Demo

There’s a demo at http://social.matiasaguirre.net/. Note: It lacks some backends’ support at the moment.

Features

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:

  • 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

  • Mail.ru OAuth

  • Odnoklassniki OAuth

  • Mixcloud OAuth2

  • BitBucket OAuth

  • Douban OAuth

  • Fitbit OAuth

  • Instagram OAuth2

  • Twilio

  • Weibo OAuth2

  • Yandex OpenId

  • Shopify OAuth2

  • StockTwits 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

Documentation

Extensive documentaion at Read the Docs.

Dependencies

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 sites

Installation

From pypi:

$ pip install django-social-auth

or:

$ easy_install django-social-auth

or clone from github:

$ git clone git://github.com/omab/django-social-auth.git

and add social_auth to PYTHONPATH:

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

or:

$ cd django-social-auth
$ sudo python setup.py install

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 https://github.com/henriklied/django-twitter-oauth

• django-openid-auth:

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