django openstack auth documentation - read the docs · django openstack auth is a pluggable django...

19
Django OpenStack Auth Documentation Release 1.1.0 Gabriel Hurley Jun 22, 2017

Upload: vohanh

Post on 22-Jul-2018

255 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: Django OpenStack Auth Documentation - Read the Docs · Django OpenStack Auth is a pluggable Django authentication backend that works with Django’s contrib ... python setup.py test

Django OpenStack AuthDocumentation

Release 1.1.0

Gabriel Hurley

Jun 22, 2017

Page 2: Django OpenStack Auth Documentation - Read the Docs · Django OpenStack Auth is a pluggable Django authentication backend that works with Django’s contrib ... python setup.py test
Page 3: Django OpenStack Auth Documentation - Read the Docs · Django OpenStack Auth is a pluggable Django authentication backend that works with Django’s contrib ... python setup.py test

Contents

1 Getting Started 31.1 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31.2 Running The Tests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

2 The User Class 5

3 The Views Module 7

4 The Forms Module 9

5 The Backend Module 11

6 The Utils Module 13

7 Indices and tables 15

i

Page 4: Django OpenStack Auth Documentation - Read the Docs · Django OpenStack Auth is a pluggable Django authentication backend that works with Django’s contrib ... python setup.py test

ii

Page 5: Django OpenStack Auth Documentation - Read the Docs · Django OpenStack Auth is a pluggable Django authentication backend that works with Django’s contrib ... python setup.py test

Django OpenStack Auth Documentation, Release 1.1.0

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

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

Contents 1

Page 6: Django OpenStack Auth Documentation - Read the Docs · Django OpenStack Auth is a pluggable Django authentication backend that works with Django’s contrib ... python setup.py test

Django OpenStack Auth Documentation, Release 1.1.0

2 Contents

Page 7: Django OpenStack Auth Documentation - Read the Docs · Django OpenStack Auth is a pluggable Django authentication backend that works with Django’s contrib ... python setup.py test

CHAPTER 1

Getting Started

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

3

Page 8: Django OpenStack Auth Documentation - Read the Docs · Django OpenStack Auth is a pluggable Django authentication backend that works with Django’s contrib ... python setup.py test

Django OpenStack Auth Documentation, Release 1.1.0

4 Chapter 1. Getting Started

Page 9: Django OpenStack Auth Documentation - Read the Docs · Django OpenStack Auth is a pluggable Django authentication backend that works with Django’s contrib ... python setup.py test

CHAPTER 2

The User Class

5

Page 10: Django OpenStack Auth Documentation - Read the Docs · Django OpenStack Auth is a pluggable Django authentication backend that works with Django’s contrib ... python setup.py test

Django OpenStack Auth Documentation, Release 1.1.0

6 Chapter 2. The User Class

Page 11: Django OpenStack Auth Documentation - Read the Docs · Django OpenStack Auth is a pluggable Django authentication backend that works with Django’s contrib ... python setup.py test

CHAPTER 3

The Views Module

7

Page 12: Django OpenStack Auth Documentation - Read the Docs · Django OpenStack Auth is a pluggable Django authentication backend that works with Django’s contrib ... python setup.py test

Django OpenStack Auth Documentation, Release 1.1.0

8 Chapter 3. The Views Module

Page 13: Django OpenStack Auth Documentation - Read the Docs · Django OpenStack Auth is a pluggable Django authentication backend that works with Django’s contrib ... python setup.py test

CHAPTER 4

The Forms Module

9

Page 14: Django OpenStack Auth Documentation - Read the Docs · Django OpenStack Auth is a pluggable Django authentication backend that works with Django’s contrib ... python setup.py test

Django OpenStack Auth Documentation, Release 1.1.0

10 Chapter 4. The Forms Module

Page 15: Django OpenStack Auth Documentation - Read the Docs · Django OpenStack Auth is a pluggable Django authentication backend that works with Django’s contrib ... python setup.py test

CHAPTER 5

The Backend Module

11

Page 16: Django OpenStack Auth Documentation - Read the Docs · Django OpenStack Auth is a pluggable Django authentication backend that works with Django’s contrib ... python setup.py test

Django OpenStack Auth Documentation, Release 1.1.0

12 Chapter 5. The Backend Module

Page 17: Django OpenStack Auth Documentation - Read the Docs · Django OpenStack Auth is a pluggable Django authentication backend that works with Django’s contrib ... python setup.py test

CHAPTER 6

The Utils Module

13

Page 18: Django OpenStack Auth Documentation - Read the Docs · Django OpenStack Auth is a pluggable Django authentication backend that works with Django’s contrib ... python setup.py test

Django OpenStack Auth Documentation, Release 1.1.0

14 Chapter 6. The Utils Module

Page 19: Django OpenStack Auth Documentation - Read the Docs · Django OpenStack Auth is a pluggable Django authentication backend that works with Django’s contrib ... python setup.py test

CHAPTER 7

Indices and tables

• genindex

• modindex

• search

15