Attributs LDAP de la carte vers les éléments sur la page d'inscription du Géoportail

Prête à l'emploi, la page d'inscription du Géoportail montre plusieurs champs qui peuvent mapper vers le LDAP d'une organisation. Notez que le nom d'utilisateur et le mot de passe sont obligatoires étant donné qu'ils sont requis pour se connecter. L'e-mail est obligatoire afin que l'administrateur du Géoportail puisse contacter un utilisateur si nécessaire. Les autres champs sont facultatifs. Cette rubrique explique la manière dont les champs peuvent être ajoutés ou supprimés de cette page d'inscription. IMPORTANT : vérifiez si vous comprenez les concepts LDAP décrits dans l'article Concepts LDAP importants avant de continuer.

Les champs affichés sur la page d'inscription sont mappés dans le LDAP et appelés "attributs". Vous pouvez voir les attributs disponibles dans votre LDAP lorsque vous affichez un utilisateur, à l'aide de l'outil de navigation d'un Répertoire comme Apache Directory Studio. Dans Apache Directory Studio, ouvrez la connexion du LDAP et allez au nœud des utilisateurs. Sélectionnez un utilisateur dans l'arborescence. Notez que lorsque l'utilisateur est sélectionné, tous les attributs assignés à cet utilisateur s'affichent dans la fenêtre à droite. Chaque entité dans la structure LDAP a les attributs qui lui sont associés. Ces attributs sont définis par le Format d'échange de données LDAP et mappez les informations vers l'utilisateur ou le groupe. Le fichier gpt.xml du Géoportail utilise les attributs définis dans le LDAP pour définir les champs dans la page d'inscription du Géoportail. Remarquez le nom des attributs dans la colonne "Description de l'attribut" à gauche. Si vous ouvrez le fichier gpt.xml à partir de votre dossier \\geoportal\WEB-INF\classes\gpt\config, vous verrez que ces attributs correspondent aux valeurs "ldapName" des attributs définies dans la section <userAttributeMap>

Il est probable que tous les attributs affichés dans votre répertoire LDAP ne soient pas indiqués dans le fichier gpt.xml et, inversement, chaque attribut du fichier gpt.xml peut ne pas être indiqué dans votre structure LDAP. La manière dont ces éléments sont définis doit être discutée avec l'administrateur du LDAP de votre organisation.

Ajout d'un champ supplémentaire à la page d'inscription du Géoportail

Suivez les étapes ci-dessous pour ajouter un champ supplémentaire à la page d'inscription du Géoportail :

1. Naviguez vers le dossier \\geoportal\WEB-INF\classes\gpt\config, puis ouvrez le fichier gpt.xml dans un éditeur de texte.
2. Créez une nouvelle balise <attribute> dans la section <userAttributeMap> du fichier gpt.xml
   • Pour l'attribut clé, donnez-lui n'importe quelle valeur de chaîne, de préférence une qui identifie facilement les données à saisir (c-à-d. telephoneExtension, employeeNumber)
   • Pour l'attribut ldapName, choisissez un attribut LDAP non utilisé par un autre attribut. Cet attribut doit correspondre à un attribut LDAP indiqué dans l'outil de navigation de votre répertoire LDAP (ex. : Apache Directory Studio).
   • Par exemple, pour ajouter un champ pour le Numéro de téléphone personnel sur la page d'inscription du Géoportail, ajoutez un nouvel attribut à la liste dans le fichier gpt.xml, comme indiqué ci-dessous. Assignez l'attribut clé comme étant "home_phone", puis mappez l'attribut ldapName vers "homePhone", un attribut non utilisé dans le LDAP comme indiqué dans la capture d'écran d'affichage de la table.

      
     <userAttributeMap>          
     <attribute key="username"     ldapName="uid"/>          
     <attribute key="password"     ldapName="userPassword"/>          
     <attribute key="email"        ldapName="mail"/>          
     <attribute key="firstName"    ldapName="givenName"/>          
     <attribute key="lastName"     ldapName="sn"/>          
     <attribute key="organization" ldapName="o"/>            
     <attribute key="affiliation"  ldapName="businessCategory"/>               
     <attribute key="street"       ldapName="street"/>                   
     <attribute key="city"         ldapName="l"/>                
     <attribute key="stateOrProv"  ldapName="st"/>                
     <attribute key="postalCode"   ldapName="postalCode"/>            
     <attribute key="country"      ldapName=""/>            
     <attribute key="phone"        ldapName="telephoneNumber"/>          
     <attribute key="home_phone" ldapName="homePhone"/>          
     </userAttributeMap>
     

3. Maintenant, naviguez vers le dossier \\geoportal\catalog\identity, puis ouvrez le fichier userAttributes.jsp dans un éditeur de texte. Ajoutez un nouvel ensemble de balises d'étiquette en sortie, en prenant soin d'utiliser le nom clé de l'attribut dans les paramètres :

   <% // home phone number %>  
   <h:outputLabel for="home_phone" rendered="#{SelfCareController.hasUserAttribute['home_phone']}"    
   value="#{gptMsg['catalog.identity.profile.label.home_phone']}"/>  
   <h:inputText id="home_phone" size="30" maxlength="128"  rendered="#{SelfCareController.hasUserAttribute['home_phone']}"    
   value="#{SelfCareController.activeUserAttributes['home_phone'].value}"/>

4. Notez que le 'catalog.identity.profile.label.home_phone' est utilisé pour générer le nom de l'étiquette sur la page d'inscription. Vous devez ajouter cette entrée à votre fichier gpt.properties dans le dossier \\geoportal\WEB-INF\classes\gpt\resources. L'exemple de nouvelle entrée dans le fichier gpt.properties pour notre Numéro de téléphone personnel est :

   catalog.identity.profile.label.home_phone	= Home Phone Number:

5. Après avoir mis à jour les fichiers userAttributes.jsp et gpt.properties, enregistrez-les, puis fermez-les. Ensuite, redémarrez l'application Web du géoportail.
6. Pour voir comment votre page d'inscription est associée au LDAP, lancez le site du Géoportail, puis cliquez sur le bouton "Inscrire".
7. Inscrivez un nouvel utilisateur en saisissant les éléments d'informations obligatoires et en fournissant également les informations que vous venez de personnaliser, par exemple, le Numéro de téléphone personnel.
8. Cliquez sur "Inscrire".
9. Maintenant, actualisez votre affichage dans le navigateur de votre répertoire LDAP pour voir le nouvel utilisateur ajouté à l'arborescence. Cliquez sur le nouvel utilisateur, puis voyez comment les propriétés, y compris le nouveau Numéro de téléphone personnel, sont mappées dans le LDAP.