Modular rewriting reverse proxy
This repository has been archived on 2023-02-21. You can view files and clone it, but cannot push or open issues or pull requests.
Go to file
Jérôme Schneider 85141684d0 Improve README and finish duonet support
* mandaye/auth/authform.py: update to support duonet replay
 * README.rst: improve the quick launch text
 * mandaye/filters/vincennes.py: filters for Duonet
 * mandaye/models.py: add birthdate for duonet
 * mandayectl: improve the cmd line management
2011-09-23 08:49:32 +02:00
mandaye Improve README and finish duonet support 2011-09-23 08:49:32 +02:00
pocs Mandaye now working for a basic reverse proxy 2011-08-10 18:15:26 +02:00
COPYING Begin Mandaye true project based on poc1.py 2011-08-04 19:28:16 +02:00
README.rst Improve README and finish duonet support 2011-09-23 08:49:32 +02:00
TODO Add a debug mode and add regexp support for the mapping 2011-09-12 16:33:29 +02:00
mandayectl Improve README and finish duonet support 2011-09-23 08:49:32 +02:00
pip-requirements.txt add a pip requirements file 2011-09-19 11:48:02 +02:00
setup.py Add portail famille mapping and add dynamic form support 2011-09-19 22:47:35 +02:00

README.rst

===============================================
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
applications.

Copying
-------

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

Features
--------

TODO: rewrite this part

 * Dispatcher
 * Filters (headers, cookies and data)
 * Password replay (form, basic auth, ...)
 * Sql and ldap authentification
 * Authentification through Authentic2 idp (SAML2 and CAS)


Installation
============

Dependencies
------------

You must install the following packages to use Mandaye

 * Gevent 0.13::

   From sources: http://pypi.python.org/pypi/gevent
   Debian based distribution: apt-get install python-gevent
 
 * Poster 0.8::

   From sources: http://pypi.python.org/pypi/poster/
   Debian based distribution: apt-get install python-poster

 * SQLAlchemy 0.7.2::

   From sources: http://pypi.python.org/pypi/SQLAlchemy

 * Beaker 1.5.4::

   From sources: http://pypi.python.org/pypi/Beaker

 * Mako 0.4.2::

   From sources: http://pypi.python.org/pypi/Mako

You can install all those dependencies quickly using pip::

   pip install gevent poster SQLAlchemy Beaker Mako

or easy_install::

   easy_install gevent poster SQLAlchemy Beaker Mako

Quick Start
-----------

Configure mandaye/config.py

Then launch the following commands::

  ./mandayectl --createdb
  ./mandayectl --start

You should see the following output::

    Database created
    Starting Mandaye x.x.x.x:xx ...