RETIRED, A Django authentication backend for use with the OpenStack Keystone Identity backend.
Go to file
Jenkins 069295fc59 Merge "Restore "redirect to login page after logout" behaviour" 2014-06-21 00:22:13 +00:00
.tx Fix translation setup 2014-05-08 19:16:12 +02:00
doc/source Merge "Switch over to oslosphinx" 2014-03-20 18:47:42 +00:00
openstack_auth Merge "Restore "redirect to login page after logout" behaviour" 2014-06-21 00:22:13 +00:00
.gitignore Align with OpenStack project standards 2013-09-10 16:58:11 -05:00
.gitreview Add OpenStack .gitreview file 2013-07-17 11:22:38 -07:00
.mailmap Align with OpenStack project standards 2013-09-10 16:58:11 -05:00
LICENSE Align with OpenStack project standards 2013-09-10 16:58:11 -05:00
MANIFEST.in Align with OpenStack project standards 2013-09-10 16:58:11 -05:00
README.rst Fixed typo in readme. 2012-07-08 16:13:13 -07:00
babel.cfg Add I18N related configurations 2013-09-27 23:07:06 +09:00
requirements.txt Updated from global requirements 2014-05-01 13:43:51 +00:00
setup.cfg Add the Python 3 classifiers 2014-05-20 15:10:20 +02:00
setup.py Updated from global requirements 2014-05-01 13:43:51 +00:00
test-requirements.txt Updated from global requirements 2014-05-28 19:13:30 +00:00
tox.ini Fix H301 and H304 hacking issues 2014-06-06 15:48:25 +09:00

README.rst

Django OpenStack Auth

Django OpenStack Auth is a pluggable Django authentication backend that works with Django's contrib.auth framework to authenticate a user against OpenStack's Keystone Identity API.

The current version is designed to work with the Keystone V2 API.

You can view the documentation on Read The Docs.

Installation

Installing is quick and easy:

  1. Run pip install django_openstack_auth.

  2. Add openstack_auth to settings.INSTALLED_APPS.

  3. Add 'keystone_auth.backend.KeystoneBackend' to your settings.AUTHENTICATION_BACKENDS, e.g.:

    AUTHENTICATION_BACKENDS = ('keystone_auth.backend.KeystoneBackend',)
  4. Configure your API endpoint(s) in settings.py:

    OPENSTACK_KEYSTONE_URL = "http://example.com:5000/v2.0"
  5. Include 'keystone_auth.urls' somewhere in your urls.py file.

  6. Use it as you would any other Django auth backend.

Running The Tests

Download the repository and run:

python setup.py test