Configuration de l'accès Rich UI au protocole LDAP

La configuration de ce projet prend environ 5 minutes.

Avant de commencer

L'exemple d'accès Rich UI au protocole LDAP requiert les éléments suivants :
  • Serveur compatible LDAP
  • IBM® WebSphere Application Server
  • Projet com.ibm.egl.rui dans votre espace de travail

Si vous ne disposez pas d'un serveur compatible LDAP, vous pouvez utiliser un serveur à source ouverte (tel qu'ApacheDS) et un client (tel qu'Apache Directory Studio) fournissant l'accès à ce serveur. Pour installer ApacheDS et Apache Directory Studio, voir Configuration du logiciel compatible LDAP.

Vérifiez que la fonction WebSphere Application Server est installée et que l'environnement d'exécution est spécifié.
  • Les fonctions sont répertoriées lors du processus d'installation et le niveau de la fonction installée doit correspondre à celui du serveur WebSphere Application. Pour identifier les fonctions installées, démarrez le gestionnaire d'installation IBM. Cliquez sur Fichier > Afficher les packages installés > IBM Rational Business Developer. Si la fonction appropriée n'est pas installée, utilisez la fonction IBM Installation Manager Modify pour l'installer.
  • Pour spécifier l'emplacement du serveur d'applications, cliquez sur Fenêtre > Préférences > Serveur > Environnements d'exécution. Sélectionnez le serveur approprié et entrez l'emplacement.

Le projet com.ibm.egl.rui est automatiquement créé lorsque vous utilisez l'assistant de création de projet EGL Rich UI. Si vous ne disposez pas de ce projet, Cliquez sur Obtenir le projet de dépendance pour l'importer dans votre espace de travail, sur la page Accès Rich UI au protocole LDAP.

Pourquoi et quand exécuter cette tâche

Pour exécuter l'exemple, procédez comme suit :

Procédure

  1. Pour importer les exemples de projet dans votre espace de travail, cliquez sur le lien Obtenir l'exemple de la page Accès Rich UI au protocole LDAP. Autorisez l'outil de migration de l'espace de travail à effectuer toute migration nécessaire . Si l'outil de migration d'espace de travail vous invite à sélectionner un serveur d'exécution, sélectionnez le WebSphere Application Server que vous utilisez pour exécuter cet exemple.
  2. Si le port par défaut pour votre serveur WebSphere Application Server n'est pas 9080, procédez comme suit :
    1. Cliquez deux fois sur WebBindings.egl dans le dossier LdapRuiSample/EGLSource/bindings pour ouvrir l'éditeur EGL.
    2. Remplacez le port de la constante ldapUri par celui utilisé par votre serveur d'exécution.
    3. Fermez le fichier pour sauvegarder les modifications.
    4. Cliquez deux fois sur LdapRuiSample.egldd dans le dossier LdapRuiSample/EGLSource pour l'ouvrir dans l'éditeur de descripteur de déploiement EGL.
    5. Cliquez sur l'onglet Liaison de service et remplacez le port de l'URI de base par celui utilisé par votre serveur d'exécution.
    6. Fermez le fichier pour sauvegarder les modifications.
    Vous pouvez rechercher le port par défaut de votre serveur d'exécution à l'aide de la console d'administration.
  3. Si vous utilisez un serveur compatible LDAP existant, accédez au projet LdapRuiServices, ouvrez les fichiers suivants et vérifiez que leur contenu est adapté à votre serveur :
    • EGLSource/libraries/LdapLoginLib.egl, dans lequel il peut être nécessaire de modifier l'entrée providerURL suivante :
      providerUrl String = "ldap://localhost:389/o=sample";
    • EGLSource/libraries/UserObjectLib.egl
  4. Dans votre projet LdapRuiSample, recherchez le fichier SampleCompany.ldif. Dans ce fichier, importez les données exemple.
    • Si vous utilisez un serveur compatible LDAP existant, importez les données exemple à partir du fichier SampleCompany.ldif qui se trouve à l'emplacement suivant :
      espace_travail/LdapRuiSample/
      Remarque : espace_travail correspond au chemin qualifié complet de l'espace de travail de votre produit EGL (par exemple C:/MyWorkspace).
    • Si vous utilisez le logiciel à source ouverte Apache à des fins de démonstration, importez les données exemple sur le serveur d'annuaire ApacheDS, en suivant les instructions de la rubrique Importation de données exemple à l'aide d'Apache Directory Studio.
  5. Pour générer le code Java™ dans LdapRuiServices pour les services Web dans le projet, cliquez avec le bouton droit de la souris sur LdapRuiServices, puis cliquez sur Générer.
  6. Pour générer le code JavaScript dans LdapRuiSample pour les parties du projet, cliquez avec le bouton droit de la souris sur LdapRuiSample, puis cliquez sur Générer.
  7. Mettez à jour le descripteur de déploiement EGL dans LdapRuiSample
    1. Cliquez deux fois sur LdapRuiSample.egldd pour ouvrir l'éditeur de descripteur de déploiement EGL.
    2. Vérifiez que le bouton d'option Projet cible est sélectionné.
    3. Cliquez sur Nouveau et tapez LdapRuiDeployed dans la zone Nom du projet.
    4. Sélectionnez une version de WebSphere Application Server comme serveur d'exécution. La valeur de la version du module Web dynamique est 2.5 pour les versions correspondant à la version 7.0 et aux versions ultérieures.
    5. Vérifiez que la case à cocher Ajouter le projet à un projet EAR est sélectionnée.
    6. Cliquez sur Nouveau projet et tapez LdapRuiDeployedEAR dans la zone Nom du projet.
    7. Cliquez sur Terminer pour créer le projet EAR.
    8. Cliquez sur Terminer pour créer le projet Web dynamique.
    9. Vérifiez que LdapRuiDeployed est spécifié comme projet cible, puis fermez l'éditeur de descripteur de déploiement, ce qui sauvegarde les modifications.
  8. Déployez l'application Rich UI :
    1. Sélectionnez LdapRuiSample.egldd.
    2. Cliquez avec le bouton droit de la souris et sélectionnez Déployer le descripteur EGL.
    Les projets LdapRuiDeployed et LdapRuiDeployedEAR s'affichent dans votre espace de travail.
  9. Ajoutez LdapRuiDeployedEAR et LdapRuiServicesEAR à votre serveur IBM WebSphere Application Server, comme suit :
    1. Dans la vue Serveurs, cliquez avec le bouton droit de la souris sur votre serveur WebSphere Application Server, puis cliquez sur Ajouter et supprimer des projets.
    2. Cliquez sur LdapRuiDeployedEAR > Ajouter.
    3. Cliquez sur LdapRuiServicesEAR > Ajouter.
    4. Cliquez sur Terminer.
  10. Dans la vue Serveurs, démarrez WebSphere Application Server.
  11. Exécutez l'application exemple Rich UI :
    1. Développez le projet LdapRuiDeployed et WebContent.
    2. Cliquez avec le bouton droit de la souris sur SampleCompany-en_US.html, puis cliquez sur Exécuter en tant que > Exécuter sur le serveur.
    3. Sélectionnez votre serveur WebSphere Application Server. Cliquez sur Terminer.
    4. Sur la page de connexion Sample Company, entrez l'un des ID utilisateur stockés sur le serveur compatible LDAP (par exemple, msmith) et entrez le mot de passe pass pour le nom utilisé. Cliquez sur Connexion.
    Les données associées à l'ID utilisateur s'affichent. Vous pouvez utiliser Apache Directory Studio pour voir les autres ID utilisateur exemple qui sont stockés dans l'annuaire compatible LDAP. Pour voir les données des autres utilisateurs, entrez d'autres ID utilisateur et utilisez pass comme mot de passe. Les zones affichées pour les employés diffèrent de celles affichées pour les clients.

    Pour éviter une erreur d'authentification, assurez-vous que le serveur d'annuaire ApacheDS est démarré. Pour des instructions sur le démarrage du serveur, reportez-vous à la fin de la rubrique Configuration du logiciel compatible LDAP.


Commentaires en retour