repoze.what's authentication plugin using INI files as source
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


repoze.what.plugins.ini -- Plugin for repoze.what authorization framework

    What is repoze.what.plugins.ini?

    repoze.what.plugins.ini is a plugin for repoze.what that offers group and
    permissions adapters for sources based on INI files.

    What is repoze.what?

    From repoze.what site:

        repoze.what is an authorization framework for WSGI applications, based
        on repoze.who (which deals with authentication).

        On the one hand, it enables an authorization system based on the groups 
        to which the authenticated or anonymous user belongs and the permissions 
        granted to such groups by loading these groups and permissions into the 
        request on the way in to the downstream WSGI application.

        And on the other hand, it enables you to manage your groups and 
        permissions from the application itself or another program, under a 
        backend-independent API. For example, it would be easy for you to switch 
        from one back-end to another, and even use this framework to migrate the

    repoze.what can be used as authorization framework for turbogear, repoze.bfg 
    or your own WSGI server.

    How to install repoze.what.plugins.ini?

    You can install the last stable version with easy_install::

        easy_install repoze.what.plugins.ini

    or the developer version via git::

        git clone git://
        cd repoze.what.plugins.ini
        python install

    The source file format

    The format used in the source files is similar to the INI file format. The 
    file consists in a serie of sections, each one with a section header of the 
    form “[section-name]”, followed by entries of the form “value”. Spaces 
    before and after section headers or entries are ignored. Characters after 
    ”#” are ignored.

    An example of a group file::





    An example of a permissions file:




    How to use it?
    All you need to do is to instantiate a repoze.what middleware using 
    repoze.what.plugins.ini.INIGroupAdapter or 

        # First, we'll need a WSGI application
        my_app = None   # Of course, you'll change None for your WSGI app

        # We need to set up the repoze.who components used by repoze.what for
        # authentication
        from repoze.who.plugins.htpasswd import HTPasswdPlugin, crypt_check
        from repoze.who.plugins.basicauth import BasicAuthPlugin

        htpasswd = HTPasswdPlugin('passwd', crypt_check)
        basicauth = BasicAuthPlugin('MyRepoze')
        identifiers = [('basicauth', basicauth)]
        authenticators = [('htpasswd', htpasswd)]
        challengers = [('basicauth', basicauth)]
        mdproviders = []

        # We'll use group and permission based exclusively on INI files
        from repoze.what.plugins.ini import INIGroupAdapter
        from repoze.what.plugins.ini import INIPermissionsAdapter

        groups = {'all_groups': INIGroupAdapter('groups.ini')}
        permissions = {'all_perms': INIPermissionsAdapter('permissions.ini')}

        # Finally, we create the repoze.what middleware
        import logging

        from repoze.what.middleware import setup_auth

        middleware = setup_auth(
            app = my_app,
            group_adapters = groups,
            permission_adapters = permissions, 
            identifiers = identifiers, 
            authenticators = authenticators,
            challengers = challengers, 
            mdproviders = mdproviders, 
            log_level = logging.DEBUG