Mandaye - modular reverse proxy to authenticate

Mandaye is a modular rewriting reverse proxy. Its main use is to add external
authentication systems to legacy application, i.e. SSO.
It dispatches HTTP requests to your applications and allow you to transform and
filter the request and the response.
Mandaye allows to couple your authentication provider with incompatible web


This software copyrighted by Entr'ouvert and is licensed under the GNU AGPL
version 3 for distribution.


  • Mapping / dispatching
    With Mandaye you can define your own mapping files. This allows you to call your own filters
    on the right HTTP requests. See the config part for more details.
  • Filters
    You can define your own filters with Mandaye. This filter have access to the WSGI environment and
    could modify the HTTP requests and / or responses.
  • Local authentification
    Mandaye provide a sql local authentification but you can also implement your own
    local authentification.
  • Distant authentification
    At the moment Mandaye only support form replay for a distant authentification but we will provide
    SAML 2.0, OpenID and CAS support.



You must install the following packages to use Mandaye

You can install all those dependencies quickly using pip

pip install gevent poster SQLAlchemy Beaker Mako lxml gunicorn

or easy_install::

easy_install gevent poster SQLAlchemy Beaker Mako lxml gunicorn

or apt-get (Debian based distributions)::

apt-get install gunicorn python-poster python-sqlalchemy python-beaker python-mako python-lxml python-setuptools

It's recommended to install the following modules

You can install this Python modules with pip

    pip install pycrypto static

Quick installation

Install at least Python >=2.5 and setuptools or distribute and enter this command in a shell

$ python install

If you want to develop use this command line

$ python develop

Quick Start

Configure MANDAYE_PATH/mandaye/ with your own preferences.
You must configure the database uri and the log file.

First create your database

$ --createdb

Launch mandaye server

$ use gunicorn and gunicorn options (please read

You could also use (in the mandaye files)






Also available in: PDF HTML TXT