Tag release 1.9.10

git-svn-id: svn://svn.forge.objectweb.org/svnroot/lemonldap/tags/lemonldap-ng_version_1_9_10@6555 1dbb9719-a921-0410-b57f-c3a383c2c641

AUTHORS

+LemonLDAP::NG Core team:
+  * David COUTADEUR
+  * François-Xavier DELTOMBE
+  * Xavier GUIMARD
+  * Clément OUDOT
+
+Past and present contributors:
+    * Hamza AISSAT
+    * Casimir ANTUNES
+    * Sébastien BAHLOUL
+    * Oliver BOIREAU
+    * Sandro CAZZANIGA
+    * Jean-Thomas CHECCO
+    * Thomas CHEMINEAU
+    * Sebastien DIAZ
+    * Hubert GAULTIER
+    * Eric GERMAN
+    * Mounir GZADY
+    * Erwan LEGALL
+    * Pascal PEJAC
+    * Daniel RIVIERE
+    * Habib ZITOUNI
+
+See http://lemonldap-ng.org/contact#the_team

INSTALL

+                          LEMONLDAP::NG INSTALLATION
+
+Lemonldap::NG is a modular Web-SSO based on Apache::Session modules. It
+simplifies the build of a protected area with a few changes in the application.
+It manages both authentication and authorization and provides headers for
+accounting. So you can have a full AAA protection.
+
+See README file to known how it works.
+
+----------------------
+I - QUICK INSTALLATION
+----------------------
+
+The proposed example use a protected site named test.example.com. Non
+authenticated users are redirected to auth.example.com.
+
+1.1 - PREREQ
+------------
+
+1.1.1 - Software
+
+To use Lemonldap::NG, you have to run a LDAP server and of course an Apache
+server compiled with mod-perl (version 1.3 or 2.x). Generaly, the version of
+Apache proposed with your Linux distribution match, but some distributions used
+an experimental version of mod_perl with Apache2 (mod_perl-1.99) which does
+not work with Lemonldap::NG. With such distributions (like Debian-3.1), you
+have to use Apache-1.3 or to use a mod_perl backport (www.backports.org
+package for Debian works fine).
+
+1.1.2 - Perl prereq
+
+Perl modules:
+  Apache::Session, Net::LDAP, MIME::Base64, CGI, LWP::UserAgent, Cache::Cache,
+  DBI, XML::Simple, SOAP::Lite, HTML::Template, XML::LibXML, XML::LibXSLT
+
+With Debian:
+  apt-get install libapache-session-perl libnet-ldap-perl libcache-cache-perl \
+                  libdbi-perl perl-modules libwww-perl libcache-cache-perl \
+                  libxml-simple-perl libhtml-template-perl libsoap-lite-perl \
+                  libxml-libxml-perl libxml-libxslt-perl
+
+1.2 - BUILDING
+--------------
+
+1.2.1 - Complete install
+
+  $ tar xzf lemonldap-ng-*.tar.gz
+  $ cd lemonldap-ng-*
+  $ make && make test
+  $ sudo make install
+
+By default, all is installed in /usr/local/lemonldap-ng except Perl libraries
+which are installed in a directory included in @INC.
+
+1.2.2 - Install on Debian
+
+  $ tar xzf lemonldap-ng-*.tar.gz
+  $ cd lemonldap-ng-*
+  $ debuild
+  $ sudo dpkg -i ../*lemonldap-ng*.deb
+
+Here, all is installed in /var/lib/lemonldap-ng, /etc/lemonldap-ng except Perl
+libraries which are installed in /usr/share/perl5/Lemonldap/NG/
+
+1.3 - EXAMPLE CONFIGURATION
+---------------------------
+
+If you have build Debian packages, configuration is done by Debconf. See
+/usr/share/doc/liblemonldap-ng-common/README.Debian to use it.
+
+After build, you have a new file named example/apache.conf. You just have to
+include this file in Apache configuration:
+
+  # in httpd.conf (with Apache1)
+  include /path/to/lemonldap-ng/source/example/apache.conf
+  # or in apache2.conf (with Apache2)
+  include /path/to/lemonldap-ng/source/example/apache2.conf
+
+Modify your /etc/hosts file to include:
+
+  127.0.0.1 auth.example.com test1.example.com manager.example.com test2.example.com
+
+Use a browser to connect to http://manager.example.com/ and specify your LDAP
+settings. If you don't set managerDn and managerPassword, Lemonldap::NG will
+use an anonymous bind to find user dn.
+
+Next, restart Apache use your prefered browser and try to connect to
+http://test1.example.com/. You'll be redirect to auth.example.com. Try
+to authenticate yourself with a valid account and the protected page will
+appear. You will find other explanations on this page.
+
+the file /usr/local/lemonldap-ng/etc/storage.conf
+(/etc/lemonldap-ng/storage.conf on Debian systems) can be modified to change
+configuration database.
+
+-------------------------
+2 - ADVANCED INSTALLATION
+-------------------------
+
+It is recommended to install the example first then to adapt it.
+
+2.1 - PREREQ
+
+2.1.1 - Apache
+
+To use Lemonldap::NG, you have to run a LDAP server and of course an Apache
+server compiled with mod-perl (version 1.3 or 2.x). Generaly, the version of
+Apache proposed with your Linux distribution match, but some distributions used
+an experimental version of mod_perl with Apache2 (mod_perl-1.99) which does
+not work with Lemonldap::NG. With such distributions (like Debian-3.1), you
+have to use Apache-1.3 or to use a mod_perl backport (www.backports.org
+package for Debian works fine).
+
+For Apache2, you can use both mpm-worker and mpm-prefork. Mpm-worker works
+faster and Lemonldap::NG use the thread system for best performance. If you
+have to use mpm-prefork (for example if you use PHP), Lemonldap::NG will work
+anyway.
+
+You can use Lemonldap::NG in an heterogene world: the authentication portal and
+the manager can work in any version of Apache 1.3 or more even if mod_perl is
+not compiled, with ModPerl::Registry or not... Only the handler (site protector)
+need mod_perl. The different handlers can run on different servers with
+different versions of Apache/mod_perl.
+
+2.1.2 - Perl prereq
+
+Warning: Handler and Portal parts both need Lemonldap::NG::Manager components
+to access to configuration.
+
+Manager:
+--------
+Apache::Session, MIME::Base64, CGI, LWP::UserAgent, DBI, XML::Simple,
+SOAP::Lite, XML::LibXML, XML::LibXSLT, Lemonldap::NG::Common
+
+With Debian:
+  apt-get install perl-modules libxml-simple-perl libdbi-perl libwww-perl
+  # If you want to use SOAP
+  apt-get install libsoap-lite-perl
+
+Portal:
+-------
+Apache::Session, Net::LDAP, MIME::Base64, CGI, Cache::Cache, DBI, XML::Simple,
+SOAP::Lite, HTML::Template, XML::LibXML, Lemonldap::NG::Common
+
+With Debian:
+  apt-get install libapache-session-perl libnet-ldap-perl perl-modules
+
+Handler:
+--------
+Apache::Session, MIME::Base64, CGI, LWP::UserAgent, Cache::Cache, DBI,
+XML::Simple, SOAP::Lite, Lemonldap::NG::Common
+
+With Debian:
+  apt-get install libapache-session-perl libwww-perl libcache-cache-perl
+
+2.2 - SOFTWARE INSTALLATION
+---------------------------
+
+If you just want to install a handler or a portal or a manager:
+
+  $ tar xzf lemonldap-ng-*.tar.gz
+  $ cd lemonldap-ng-*/Lemonldap-NG-(Portal|Handler|Manager)
+  $ perl Makefile.PL && make && make test
+  $ sudo make install
+
+else for a complete install:
+
+  $ tar xzf lemonldap-ng-*.tar.gz
+  $ cd lemonldap-ng-*
+  $ make && make test
+  $ sudo make install