{{tag>SSO howto installation}}
====== Installation de LemonLDAP::NG ======

LemonLDAP::NG est un web SSO (Single Sign On) qui permet de n'avoir a s'authentifier qu'une seule fois pour un ensemble donné d'applications déclarées dans LemonLDAP::NG.

Il permet bien entendu de gérer les ACLs sur ces applications.

LemonLDAP::NG se compose de 5 éléments :

    * le portail d'authentification
    * le Manager
    * les agents protégeant les applications (ou les reverse-proxies)
    * la base de données de configuration
    * la base de données des sessions utilisateur

===== Prérequis =====

Pour realiser cette installation nous partirons d'une debian lenny flambant neuve.

L'installation a été réalisée dans une VM en 64bits, mais ne devrait pas etre modifiée ni une machine physique ni pour une installation sur architecture i386.

La derniere version stable a ce jour est la 0.9.4 telechargeable ici : <code>http://forge.ow2.org/project/showfiles.php?group_id=274</code>
la version debian sera donc choisie

<note> la version incluse officielle dans la lenny est la 0.9.2, donc la version 0.9.4 lui sera préférée</note>

==== Installation des dependances ====

<code>apt-get install libapache2-mod-perl2 libapache-session-perl libwww-perl libcache-cache-perl libxml-simple-perl libnet-ldap-perl libhtml-template-perl libjs-jquery libxml-libxml-perl libxml-libxslt-perl libstring-random-perl libsoap-lite-perl libdbi-perl libregexp-assemble-perl libcrypt-rijndael-perl libxml-simple-perl </code>

==== Installation initiale ====

Une fois extrait, le tar.gz contient les paquets .deb qu'il faut donc installer :<code>
dpkg -i lemonldap-ng-doc_0.9.4.1-2_all.deb
dpkg -i liblemonldap-ng-conf-perl_0.9.4.1-2_all.deb
dpkg -i liblemonldap-ng-handler-perl_0.9.4.1-2_all.deb
dpkg -i liblemonldap-ng-portal-perl_0.9.4.1-2_all.deb
dpkg -i lemonldap-ng_0.9.4.1-2_all.deb
</code>

==== Activation des vhosts apache ====
<code>ln -s /etc/lemonldap-ng/manager-apache2.conf /etc/apache2/sites-enabled/
ln -s /etc/lemonldap-ng/portal-apache2.conf /etc/apache2/sites-enabled/
</code>

==== Configuration des VHosts apache ====
  * Manager \\ editer le fichier "/etc/lemonldap-ng/manager-apache2.conf " et remplacez le domaine "example.com" par le votre. \\ Dans mon cas :<code>
ServerName manager.exemple.com</code>devient <code>
ServerName manager.kvm.vm</code>Pensez aussi a adapter le Allow from pour vous :<code>
Allow from 127.0.0.0/8</code>devient donc dans mon cas <code>
Allow from 127.0.0.0/8
Allow from 172.16.65.1/32</code>\\ :!: attention a ne pas "trop" ouvrir l'acces a cette interface d'admin :!:

  * Portail d'authentification :\\ editer le fichier "/etc/lemonldap-ng/portal-apache2.conf" et remplacez le domaine "example.com" par le votre. \\ Dans mon cas :<code>ServerName auth.example.com</code> devient <code>ServerName auth.kvm.vm</code>

  * Pour la prise en charge de ces vhosts : \\ remplacer <code>NameVirtualHost *:80</code> par <code>NameVirtualHost *</code> dans le fichier "/etc/apache2/ports.conf"


  * Et pour prendre tout ca en compte <code>/etc/init.d/apache2 restart</code>

<note>Il faut bien sur que les noms DNS que vous renseignez comme ServerName existant, sinon bien penser a renseigner votre fichier /etc/hosts sur votre poste ainsi que sur le serveur lemonldap lui meme (et vos serveurs d'application).
Bien entendu vous ne pourrez pas utiliser LemonLDAP::NG est les applications sans avoir fait ca sur tous les postes, a vous de choisir quelle solution vous préférez :p</note>