django_pypuppetdb 0.2.1

Handles authorization for Django by using puppetdb users

django-pypuppetdb

django-pypuppetdb is a library that handles authentication by using the PuppetDB’s REST API to get Users that are registrated in PuppetDB. It is implemented using the requests library.

To use this library you will need:

• Python 2.7+

• Python 3.3+

• Django 1.8

• pypuppetdb

Installation

You can install this package from source or from PyPi.

$ pip install django-pypuppetdb

$ git clone https://github.com/nedap/django-pypuppetdb
$ python setup.py install

Django

To let django connect to puppetdb in order to get your user add the following line to you settings.

• add “django_pypuppetdb” to INSTALLED_APPS.

• add “django_pypuppetdb.django_authentication.PuppetDBAuthentication” to AUTHENTICATION_BACKENDS

• add the followin settings

PUPPETDB_HOST = 'localhost',
PUPPETDB_PORT = 8080,
PUPPETDB_NODE = 'node',
PUPPETDB_KEY = None,
PUPPETDB_CERT = None,
PUPPETDB_SSL_VERIFY = False
PUPPETDB_ADMIN_GROUP = 'admins'

Tastypie

If you are using tastypie as API framework and want to use pypuppetdb to validate the user you can add the following line to your resource file

from django_pypuppetdb.tastypie_authentication import PuppetDBAuthentication

in your class Meta add:
authentication = PuppetDBAuthentication()

if you would like to use multiple authentications you can use

authentication = MultiAuthentication(ApiKeyAuthentication(), PuppetDBAuthentication())

Getting Help

This project is still very new so most likely there will be issues you’ll run into.

For bug reports you can file an issue. If you need help with something feel free to hit up @eagllus by e-mail.

Changelog

0.0.1

Initial release. Implements most of authorization for django.

0.0.2

Separating Django and Tastypie dependency.

0.0.3

Renaming Django authenticaton and updated all tests Renaming Tastyie authentication and updated all tests

0.1.0

Django and Tastypie fully tested

0.1.1

Adding check for puppet group that will check if the user is in the group defined in PUPPETDB_ADMIN_GROUP. This will give the user admin rights allowing the user to login django-admin.

0.2.0

Updating files to make it django 1.8 compatible.

0.2.1

Updating requirements file to newest versions.