Skip to main content

Extensible session based authentication and claims based authorization tool for CherryPy

Project description

Extensible session based authentication and claims based authorization tool for CherryPy.

Includes authentication controllers for default dispatcher and method dispatcher.

Default authentication controllers are provided in lribeiro.cherrypy.authorizer.authentication for default dispatcher and method dispatcher.

Note that if you have a callable class, the class itself must be decorated with @authorize.

Developed under Python3.4 and tested against Python2.7, Python3.4 and pypy.

Example:

import cherrypy

from lribeiro.cherrypy import authorizer
from lribeiro.cherrypy.authorizer import authorize
from lribeiro.cherrypy.authorizer.authentication import Identity, AuthControllerDefaultDispatcher

# authenticator function signature can be whatever you'd like,
# as soon as you pass the correct parameters via Http POST
def _authenticator(username, password):
    if username == 'user' and password == 'pass':
        return Identity('id', 'user')


def _authorizer(claims):
    if 'read' in claims and claims['read'] == 'page':
        return True
    if 'write' in claims and claims['write'] == 'page':
        return True
    return False

class Area1:
    @cherrypy.expose
    @authorize({'read': 'page'})
    def index(self):
        return 'authorized'


@authorize
class Area2:
    @cherrypy.expose
    def index(self):
        return 'authorized'

    @cherrypy.expose
    @authorize({'write': 'site'})
    def restricted(self):
        return 'restricted'

@authorize  # callable class itself must be decorated, not the __call__ method
class Area3:
    exposed = True

    def __call__(self):
        return 'callable class'

class Root:
    @cherrypy.expose
    def index(self):
        pass

@cherrypy.expose
def process_login(self, username, password):
    try:
        authenticate(username=username, password=password)
        raise cherrypy.HTTPRedirect('/area1')
    except AuthenticationError:
        raise cherrypy.HTTPError(403)


if __name__ == '__main__':
    conf = {
        '/': {
            'tools.sessions.on': True,
            'tools.authorizer.on': True,
            'auth.authenticator': _authenticator,
            'auth.authorizer': _authorizer,
            'auth.login_page': '/login',
            'auth.login_redirect': '/logged_in',
            'auth.logout_redirect': '/logged_out',
            'auth.unauthorized_redirect': '/unauthorized'
        }
    }

    root = Root()
    root.area1 = Area1()
    root.area2 = Area2()
    root.auth = AuthControllerDefaultDispatcher()

    cherrypy.quickstart(root, '/', conf)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for lribeiro.cherrypy.authorizer, version 1.0.2
Filename, size File type Python version Upload date Hashes
Filename, size lribeiro.cherrypy.authorizer-1.0.2-py2.py3-none-any.whl (10.2 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size lribeiro.cherrypy.authorizer-1.0.2.tar.gz (6.2 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page