/README.rst
ReStructuredText | 192 lines | 139 code | 53 blank | 0 comment | 0 complexity | a215afb0594d5366eaa1dcb02820d567 MD5 | raw file
- 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
- 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:
- * `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`_
- * `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
- Demo
- ----
- There's a demo at http://social.matiasaguirre.net/.
- Note: It lacks some backends' support at the moment.
- Contact
- -------
- 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.
- Documentation
- -------------
- Extensive documentation 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.
- .. _django-twitter-oauth: https://github.com/henriklied/django-twitter-oauth
- .. _django-openid-auth: https://launchpad.net/django-openid-auth
- .. _Read the Docs: http://django-social-auth.readthedocs.org/
- .. _Google OpenID: http://code.google.com/apis/accounts/docs/OpenID.html
- .. _Google OAuth: http://code.google.com/apis/accounts/docs/OAuth.html
- .. _Google OAuth2: http://code.google.com/apis/accounts/docs/OAuth2.html
- .. _Yahoo OpenID: http://openid.yahoo.com/
- .. _OpenId: http://openid.net/
- .. _myOpenID: https://www.myopenid.com/
- .. _Twitter OAuth: http://dev.twitter.com/pages/oauth_faq
- .. _Facebook OAuth: http://developers.facebook.com/docs/authentication/
- .. _DISQUS OAuth: http://disqus.com/api/docs/auth/
- .. _LiveJournal OpenID: http://www.livejournal.com/support/faqbrowse.bml?faqid=283
- .. _Orkut OAuth: http://code.google.com/apis/orkut/docs/rest/developers_guide_protocol.html#Authenticating
- .. _Linkedin OAuth: https://www.linkedin.com/secure/developer
- .. _Foursquare OAuth2: https://developer.foursquare.com/docs/oauth.html
- .. _GitHub OAuth: http://developer.github.com/v3/oauth/
- .. _Dropbox OAuth: https://www.dropbox.com/developers_beta/reference/api
- .. _Flickr OAuth: http://www.flickr.com/services/api/
- .. _Vkontakte OAuth: http://vk.com/developers.php?oid=-1&p=%D0%90%D0%B2%D1%82%D0%BE%D1%80%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D1%8F_%D1%81%D0%B0%D0%B9%D1%82%D0%BE%D0%B2
- .. _MSN Live Connect OAuth2: http://msdn.microsoft.com/en-us/library/live/hh243647.aspx
- .. _Skyrock OAuth: http://www.skyrock.com/developer/
- .. _Yahoo OAuth: http://developer.yahoo.com/oauth/guide/oauth-auth-flow.html
- .. _Evernote OAuth: http://dev.evernote.com/documentation/cloud/chapters/Authentication.php
- .. _Mail.ru OAuth: http://api.mail.ru/docs/guides/oauth/
- .. _Odnoklassniki OAuth: http://dev.odnoklassniki.ru/wiki/display/ok/The+OAuth+2.0+Protocol
- .. _Mixcloud OAuth2: http://www.mixcloud.com/developers/documentation/#authorization
- .. _BitBucket OAuth: https://confluence.atlassian.com/display/BITBUCKET/OAuth+Consumers
- .. _Douban OAuth: http://www.douban.com/service/apidoc/auth
- .. _Fitbit OAuth: https://wiki.fitbit.com/display/API/OAuth+Authentication+in+the+Fitbit+API
- .. _Instagram OAuth2: http://instagram.com/developer/authentication/
- .. _Twilio: https://www.twilio.com/user/account/connect/apps
- .. _Weibo OAuth2: http://open.weibo.com/wiki/Oauth2
- .. _Yandex OpenId: http://openid.yandex.ru/
- .. _Shopify OAuth2: http://api.shopify.com/authentication.html
- .. _StockTwits OAuth2: http://stocktwits.com/developers/docs/authentication
- .. _auth.User: http://code.djangoproject.com/browser/django/trunk/django/contrib/auth/models.py#L186
- .. _python-openid: http://pypi.python.org/pypi/python-openid/
- .. _python-oauth2: https://github.com/simplegeo/python-oauth2
- .. _OAuth: http://oauth.net/
- .. _pypi: http://pypi.python.org/pypi/django-social-auth/
- .. _github: https://github.com/omab/django-social-auth
- .. _django-social-auth discussion list: https://groups.google.com/forum/?fromgroups#!forum/django-social-auth