Fork me on GitHub

Installation

Il existe plusieurs possibilités d'installation en fonction de la distribution employée :

  • Distribution binaire : Le contenu du fichier zip de la distribution binaire doit être décompressé dans une webapp contenant déjà le coeur de lutèce.
  • Sources : Dans ce cas il est nécessaire d'ajouter les dépendances au coeur afin de compiler les sources et de se retrouver avec une distribution binaire.

Remarque :
Il est possible d'obtenir un fichier war déployable en utilisant un packaging de type lutece-site. Ce fichier doit être placé dans le répertoire webapps de votre installation de Tomcat. Il sera automatiquement déployé lors du lancement du serveur.


Configuration

Mode Portail

La configuration correspond à la configuration classique d'un portail Lutèce.

Mode Standalone

Ce module peut fonctionner en mode Standalone, pour ce faire, il est nécessaire de commenter la déclaration du pool portal dans le fichier db.properties. De plus, il est nécessaire d'activer le plugin manuellement, en ajoutant la ligne suivante dans le fichier plugins.dat :
selfregistration.installed=1

selfregistration.properties

Le fonctionnement du plugin Self Registration peut être reconfiguré en modifiant ce fichier.

On pourra notament personnaliser, l'url de redirection depuis le dernier écran du formulaire, la taille des listes déroulantes Les pattern de validation de certain champs, le message d'erreur lors de la connexion avec l'annuaire ...

Propriété Description
selfregistration.civility.items.numbers Nombre de choix dans la liste déroulante du champ "Civilité".
selfregistration.streetNumberSuffix.items.numbers Nombre de choix dans la liste déroulante du champ "Numéro de la voie (Suffixe)".
selfregistration.streetType.items.numbers Nombre de choix dans la liste déroulante du champ "Type de la voie".
selfregistration.districtNumber.items.numbers Nombre de choix dans la liste déroulante du champ "Arrondissement".
selfregistration.url.default.redirect Url de redirection, après l'écran de confirmation d'un enregistrement ou d'une modification.
selfregistration.phoneNumber.pattern Expréssion régulière de validation du champ "Numéro de téléphone".
selfregistration.portalCode.pattern Expréssion régulière de validation du champ "Code postal".
selfregistration.streetNumber.pattern Expréssion régulière de validation du champ "Numéro de la voie (Numéro)".
elfregistration.message.ldap.error Libéllé du message d'erreur lors d'une erreur de communication avec l'annuaire Ldap.

selfregistration_context.xml

Le fonctionnement du plugin Self Registration peut être reconfiguré en modifiant ce fichier.

On pourra configurer les informations nécéssairent pour la connexion à l'annuaire Ldap.


<beans>
  
  <bean id="selfregistrationLdapUserDAO"  class="fr.paris.lutece.plugins.selfregistration.business.LdapUserDAO">
  	 <property name="contextFactory" value="com.sun.jndi.ldap.LdapCtxFactory"/>
  	 <property name="providerUrl" value=""/>
  	 <property name="ou" value=""/>
  	 <property name="securityAuthentication" value="simple"/>
  	 <property name="login" value=""/>
  	 <property name="password" value=""/>
  	 <property name="poolMaxSize" value="10"/>
  	 <property name="poolPrefSize" value="50"/>
  	 <property name="poolTimeout" value="10000"/>
	 <property name="ldapAttributes">
	    <props>
	        <prop key="ldap.attribute.uid">uid</prop>
		    <prop key="ldap.attribute.cn">cn</prop>
		    <prop key="ldap.attribute.objectClass">objectClass</prop>
		    <prop key="ldap.attribute.objectClass.person">person</prop>
		    <prop key="ldap.attribute.objectClass.top">top</prop>
		    <prop key="ldap.attribute.objectClass.orgPerson">organizationalPerson</prop>
		    <prop key="ldap.attribute.objectClass.inetOrgPerson">inetOrgPerson</prop>
		    <prop key="ldap.attribute.objectClass.parisPerson">parisPerson</prop>
		    <prop key="ldap.attribute.civility">title</prop>
		    <prop key="ldap.attribute.lastName">sn</prop>
		    <prop key="ldap.attribute.givenName">givenName</prop>
		    <prop key="ldap.attribute.mail">mail</prop>
		    <prop key="ldap.attribute.userPassword">userPassword</prop>
			<prop key="ldap.attribute.phoneNumber">telephoneNumber</prop>
			<prop key="ldap.attribute.streetNumber">streetNumber</prop>
			<prop key="ldap.attribute.streetNumberSuffix">streetNumberSuffix</prop>
			<prop key="ldap.attribute.streetType">streetType</prop>
			<prop key="ldap.attribute.streetName">street</prop>
			<prop key="ldap.attribute.districtNumber">districtNumber</prop>
			<prop key="ldap.attribute.postalCode">postalCode</prop>
			<prop key="ldap.attribute.stateProv">st</prop>
			<prop key="ldap.attribute.city">l</prop>
			<prop key="ldap.attribute.country">co</prop>
	    </props>
	 </property>
  </bean>

</beans>
				

Description des propriétés :

Propriété Description
contextFactory Classe utilisé pour la construction du contexte Ldap. (toujours la valeur "com.sun.jndi.ldap.LdapCtxFactory" pour la connexion à un annuaire Ldap).
providerUrl Url de l'annuaire Ldap.
ou Derniers noeud du DN (Valeur : "Utilisateurs").
securityAuthentication Type de l'authentification (Valeur : "Simple". Login/Mot de passe).
login Utilisateurs DN de l'annuaire Ldap.
password Mot de passe de l'utilisateur DN.
poolMaxSize Nombre maximum de connexions par connexion identité qui peuvent être maintenues en même temps.
poolPrefSize le meilleur nombre de connexions par connexion identité qui doit être simultanément maintenu.
poolTimeout nombre de millisecondes après les quelles une connexion inactive et déconnectée du pool Ldap.
ldapAttributes Liste des attributs de l'annuaire Ldap utilisés par le plugin.