django-social-auth
Readme
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_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_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 http://social.matiasaguirre.net/. 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 sites
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
If you're having problems with using the project, use the support forum at CodersClan.
.. image:: http://www.codersclan.net/graphics/getSupport_github4.png :width: 100px :height: 100px :scale: 10 :target: http://codersclan.net/forum/index.php?repo_id=7
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: https://developers.google.com/accounts/docs/OpenID .. _Google OAuth: https://developers.google.com/accounts/docs/OAuth .. _Google OAuth2: https://developers.google.com/accounts/docs/OAuth2 .. _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 .. _Trello: https://trello.com/docs/gettingstarted/index.html#getting-an-application-key .. _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 .. _Stackoverflow OAuth2: http://api.stackexchange.com/ .. _Fedora OpenID: https://fedoraproject.org/wiki/OpenID .. _Exacttarget HubExchange: http://code.exacttarget.com/ .. _Appsfuel OAuth2: http://docs.appsfuel.com/api_reference#api_reference
FAQs
Django social authentication made simple.
We found that django-social-auth demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
CISA launched a new project called Vulnrichment to enrich CVEs with details that help prioritize patching and mitigation efforts, as the NVD backlog of unenriched CVEs awaiting analysis surpasses 10,000.
Security News
Socket is joining forces with CISA and other industry leaders at the RSA Conference to sign the Secure by Design pledge, committing to uphold the highest security standards in our products.
Research
The Socket research team breaks down a sampling of malicious packages that download and execute files, among other suspicious behaviors, targeting the popular Discord platform.