Pré-requis

Ce module nécessite une version 2.1.2 ou supérieure du noyau Lutece (lutece-core)

Le plugin MyLutece doit être installé dans une version 2.1.0 ou supérieure

Fabrication et déploiement (build et deploy)

Pour construire la dernière version du module suivez les instructions suivantes :

(NB: Le client Subversion et Maven2 doivent être installés sur votre système)

$ svn export http://dev.lutece.paris.fr/svn/lutece/portal/trunk/plugins/module-mylutece-openid module-mylutece-openid
$ cd module-mylutece-openid
$ mvn lutece:assembly

La dernière commande construit un package du module sous la forme d'un zip dénommé module-mylutece-openid-xxx-bin-xxxx.zip dans le répertoire ./target/assembly

Pour déployer ce package, il suffit simplment de la dézipper dans la racine de votre webapp.

Configuration

Une fois le module dézippé dans la webapp, activer le par l'interface "Gestion des plugins" du module d'administration

Vérifier dans le fichier WEB-INF/conf/plugins/mylutece.properties que l'authentification est bien activée comme suit :

# Enable authentication
mylutece.authentication.enable=true

Usage

La page d'authentification OpenID s'appelle à partir de l'URL suivante :

http://myhost/lutece/jsp/site/Portal.jsp?page=openid

Il est possible de réaliser ce formulaire d'authentification dans un portlet, soit en copiant le contenu du formulaire dans un portlet HTML, soit en modifiant la feuille de style XSL du portlet MyLutece.

Dépannage

• Vérifiez bien la configuration de MyLutece comme indiqué ci-dessus.
• Assurez-vous que le module OpenID est le seul module MyLutece présent dans la Webapp. Il ne doit pas y avoir d'autres fichiers mylutece-xxxxx.properties dans le répertoire WEB-INF/conf/plugins/.
• L'activation des logs en mode debug se fait en ajoutant la ligne suivante dans le fichier WEB-INF/conf/config.properties dans la rubrique LOGGERS :

  log4j.logger.openid=DEBUG, Console