Prérequis pour l'installation du module LAAP

Notation

Dans l'ensemble du document, les chemins de fichier de l'application sont donnés à partir de la racine du projet, c'est-à-dire du répertoire contenant le fichier POM. Ce répertoire sera noté "laap".

La terminologie Liberty Alliance est largement employée, en particuliers en ce qui concerne les acronymes : IdP : fournisseur d'identité (Identity Provider) ; SP : fournisseur de service (Service Provider) ;

Prérequis

Afin de tester le logiciels LAAP, les prérequis suivants sont nécessaires :

  • java 1.5 ou supérieur ;
  • un annuaire LDAP avec des utilisateurs ;
  • un serveur d'identité Liberty Alliance (seul Authentic a été testé) ;
  • un fournisseur d'attribut Liberty Alliance pouvant effectuer des requêtes par web service sur les attributs Liberty Alliance de type « Personnal Profile » (seul unwind a été testé).
Dans la suite de ce document, il est supposé que l'IDP est accessible à l'URL "http://la-idp.org", que le consommateur d'attributs est accessible à l'URL "http://la-ar". Ces deux serveurs appartiennent au même cercle de confiance. De plus, l'annuaire LDAP est accessible via l'URL "ldap://ldap-directory:1389/" ; il contient un branche « people » où sont stockés les utilisateurs. Si vous n'avait pas d'annuaire pré-installer, vous pouvez utiliser la version de démonstration embarquée d'OpenDS à condition de suivre la procédure supplémentaire à cette page: Installer OpenDS dans le repository Maven 2.

Installation des logiciels tiers

LAAP utilise Maven2 comme outils de build. Celui-ci rend automatique l'installation des toutes les bibliothèques purement JAVA. Cependant, LASSO est une bibliothèque C qu'il faut installer en plus, et signaler à Maven 2.

Installation de maven 2

L'installation de Maven 2 se fait simplement par les étapes suivantes : 

% wget "http://apache.fastorama.com/dist/maven/binaries/maven-2.0.7-bin.tar.gz"
  • décompression :
% tar xzf maven-2.0.7-bin.tar.gz
  • ajout du répertoire « bin » au PATH :
% export export $PATH=${PATH}:/path/to/maven2/bin/

Une fois ceci fait, la commande « mvn –version » doit renvoyer la version de Maven que vous venez d'installer : 

% mvn --version
Maven version: 2.0.7

Installation de LASSO et ajout au dépôt local Maven

L'installation de LASSO dépend de votre système, consulter « http://lasso.entrouvert.org/ » pour plus d'information. Le binding LASSO pour JAVA, « liblasso-java », doit également être installé. Il faut choisir les versions de LASSO ayant le support WSF activé pour pouvoir utiliser les fonctions de partage d'attribut de LAAP.

La version utilisée au cours du développement est la version 2.2.1-1.wsf. Les versions précédentes et supérieur à la 1.9.0 devraient fonctionner sans trop de problèmes à condition de prendre les versions compilées avec le support WSF. Il faut ajouter LASSO au dépôt local de Maven 2. Pour cela, executer la commande suivante : 

%mvn install:install-file -Dfile=/path/to/lasso.jar -DgroupId=com.entrouvert -DartifactId=lasso -Dversion=X.X -Dpackaging=jar -DgeneratePom=true

Avec X.X remplacé par le numéro de version de la bibliothèque installée. Le jar de du binding Java pour LASSO devrait se trouver au chemin « /usr/share/java/lasso.jar », mais ceci peut dépendre de votre distribution.

Ajout de LDAP Booster Pack au dépôt Maven 2

Spring-LDAP utilise le booster pack de Sun fourni dans le Jar ldapbp.jar. Ce jar n'est pas disponible dans les dépôts standard de Maven, il faut donc l'ajouter à la main.

Pour le télécharger, rendez vous sur la page JNDI dowloads et choisissez Download JNDI 1.2.1 & More, puis JNDI/LDAP Booster Pack 1.0

Après avoir dézippé l'archive, placez dans le répertoire "lib". Nous pouvons maintenant l'ajouter au dépôt local de maven :

% mvn install:install-file -DgroupId=com.sun -DartifactId=ldapbp -DgeneratePom=true -Dversion=1.0 -Dpackaging=jar -Dfile=ldapbp.jar