Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
django auth backend
Python Shell
branch: master

README.rst

django-netauth

Django netauth is django application that allows authenticate users through OpenID/OAuth/Google/Twitter/Facebook/Vkontakte. Example project deployed on http://netauth.node42.org/

Sorry django-netauth not nore supported now. Im recomended use django-socialauth.

Requirements

  • python >= 2.5
  • django >= 1.2
  • python-openid
  • oauth2

Installation

Django netauth should be installed using pip:

pip install django-netauth

Setup

  • Add 'netauth' to INSTALLED_APPS

    INSTALLED_APPS += ( 'netauth', )
    
  • Add netauth urls to base urls

    url('auth/', include( 'netauth.urls')),
    
  • Add netauth backend to AUTHENTICATION_BACKENDS

    AUTHENTICATION_BACKENDS += ( 'netauth.auth.NetBackend', )
    
  • Syncronize database with django syncdb command

    ./manage.py syncdb
    
  • See services setup bellow.

Use netauth

  1. Use url '/auth/login' as login point in your site
  2. Use template tag 'netauth_widget'
  3. Create custom interface

Extra fields

In order to fill extra fields that may be required by your user profile, you need to setup couple of variables in settings.py of your project.

The name of variable should be uppercased name of backend + "_PROFILE_MAPPING". For example: GOOGLE_PROFILE_MAPPING, TWITTER_PROFILE_MAPPING, etc..

The value of this variable must be dictionary with name of the field on the provider side and its value must be name of your form field. For example:

TWITTER_PROFILE_MAPPING = { 'username': 'screen_name', }

Here you can see that 'screen_name' is what you asking from twitter, in your EXTRA_FORM you will see the value of this under key 'username'. This is because every authentication method can provide different names for its data and you need to unify it.

Also you can override the EXTRA_FORM itself and set NETAUTH_EXTRA_FORM variable with value as path to your custom form. Dont forget to implement save method in this form.

Facebook

Twitter

  • Go to http://twitter.com/apps/new and create application Application type: Browser Callback URL: http://your_domain/auth/complete/
  • Set TWITTER_CONSUMER_KEY, TWITTER_CONSUMER_SECRET in your settings file

Yandex

Vkontakte

Changes

Make sure you`ve read the following document if you are upgrading from previous versions of scss:

http://packages.python.org/django-netauth/changes.html

Note

You need to setup messages-framework as described in django documentation

Bug tracker

If you have any suggestions, bug reports or annoyances please report them to the issue tracker at https://github.com/klen/django-netauth/issues

Contributing

Development of django-netauth happens at github: https://github.com/klen/django-netauth

Contributors

License

Licensed under a GNU lesser general public license.

Something went wrong with that request. Please try again.