Configuration des applications pour l'utilisation du mappage EIM

Avant de configurer les applications pour l'utilisation du mappage EIM, vous devez importer un fichier d'archive des ressources connecteur externes (fichier RAR) dans votre espace de travail.
  1. Dans l'environnement de développement intégré, sélectionnez Fichier > Importer.
  2. Sélectionnez J2EE > Fichier RAR , puis cliquez sur Suivant.
  3. Dans la boîte de dialogue Importation de connecteur, cliquez sur Parcourir et accédez au répertoire C:\Program Files\IBM\SDP70Shared\plugins\com.ibm.etools.iseries.webtools.ae_<ver>\lib, où C:\IBM\SDP70Shared correspond au répertoire des ressources partagées tel qu'indiqué dans Installation Manager et <ver> correspond à l'identificateur de compilation le plus récent.
  4. Deux versions du connecteur JCA sont livrées avec Rational Developer for System i version 7.1 :
    • Le connecteur JCA version 1.5 doit être utilisé pour WebSphere Application Server version 6.0 ou suivante.
    • Le connecteur JCA version 1.0 peut être utilisé pour WebSphere Application Server versions 5.1 et 6.0. Ce connecteur a également été mis à jour.

    Sélectionnez le fichier eimIdTokenRA.rar (pour JCA 1.0) ou eimIdTokenRA.JCA15.rar (pour JCA 1.5), puis cliquez sur Ouvrir pour l'ajouter à la boîte de dialogue Importation de connecteur.

  5. Dans la liste, sélectionnez le projet EAR.
    Remarque : Quatre fichiers RAR sont fournis. Le fichier eimIdTokenRA.JCA15.rar (ou eimIdTokenRA.rar pour JCA 1.0) encapsule eim.jar et facilite le déploiement. Les fichiers idTokenRA.rar et idTokenRA.JCA15.rar ne contiennent pas eim.jar et nécessitent l'intervention d'un utilisateur pour l'ajouter et configurer le chemin de classe du serveur.
  6. Cliquez sur Terminer pour importer le fichier RAR.

    Maintenant, configurez l'adaptateur de ressources pour l'utilisation du domaine que vous avez créé précédemment.

  7. Activez la vue Navigateur. Si celle-ci n'est pas visible, vous pouvez l'afficher en sélectionnant Fenêtre > Afficher la vue > Autre > Général > Navigateur. Développez le dossier EAR de votre projet. Développez le répertoire META-INF et cliquez deux fois sur le fichier descripteur de déploiement EAR (application.xml).
  8. En bas de la zone d'édition, cliquez sur l'onglet Déploiement et développez la section Authentification.
  9. Cliquez sur Ajouter pour configurer l'authentification JAAS de l'administrateur LDAP. Complétez l'ID et le mot de passe administrateur, puis cliquez sur OK.
  10. Développez la section Options externes J2C.
  11. Cliquez sur le bouton Ajouter en regard de l'option Adaptateurs de ressources J2C. La boîte de dialogue Création d'adaptateurs de ressources s'affiche avec le nom de l'adaptateur de ressources eimIdTokenRA (ou emIdTokenRA.JCA15) dans la zone Nom de l'adaptateur de ressources. Cliquez sur OK pour fermer la boîte de dialogue.
  12. Cliquez sur le bouton Ajouter en regard de l'option Fabriques de connexions J2C. La boite de dialogue Création d'une fabrique de connexions apparaît.

  13. Affectez un nom à la fabrique de connexions.
  14. Dans la zone Nom JNDI, affectez un nom JNDI à la fabrique de connexions (eis/idTokenRoot, par exemple).
  15. Définissez l'option Nombre maximal de connexions sur 10.
  16. Tous les autres paramètres de cette boîte de dialogue doivent conserver leurs valeurs par défaut. Cliquez sur OK pour fermer la boîte de dialogue.
  17. Cliquez sur la fabrique de connexions qui vient d'être créée dans la liste des fabriques de connexions J2C, puis cliquez sur Propriété de configuration. La boîte de dialogue Modifier la propriété de configuration s'ouvre.
  18. Dans Propriétés des ressources, saisissez les informations nécessaires pour configurer la fabrique de connexions. Voici quelques exemples de paramètres par défaut :
    • KeyTimeoutSeconds : Indique, en secondes, le délai d'expiration de la clé. Définissez cette valeur sur 1200.
    • KeySize : Indique la taille de la clé, en octets. Définissez cette valeur sur 512.
    • LdapHostName : Nom d'hôte ou adresse IP du système System i distant.
    • LdapHostPort : Port sur lequel s'exécute le service LDAP. Définissez cette valeur sur 389.
    • SourceRegistryName : Nom du registre source.
    • EimDomainName : Nom de domaine EIM.
    • ParentDomain : Nom complet du domaine parent, au format paire=valeur. Par exemple, si le nom de votre domaine parent est torasbcc.torolab.ibm.com, alors la valeur de ParentDomain doit être dc=torasbcc,dc=torolab,dc=ibm,dc=com.
    • TrustStoreName : Chemin du fichier de clés certifiées.
    • TrustStorePassword : Mot de passe du fichier de clés certifiées.
    • KeyStoreName : Chemin du fichier de clés.
    • KeyStorePassword : Mot de passe du fichier de clés.

    Vous trouverez des informations supplémentaires sur ces paramètres dans la documentation de WebSphere Application Server for i5/OS.

  19. Enregistrez et fermez la configuration du serveur.
  20. Dans la vue Serveurs, cliquez avec le bouton droit de la souris sur le serveur de test et sélectionnez Redémarrer pour le lancer.
Concepts associés
Descripteur de déploiement

Configuration des paramètres d'authentification de l'application WebFacing

Si vous utilisez l'outil WebFacing, configurez les paramètres d'authentification dans les propriétés d'exécution du projet. Pour savoir comment définir les options d'authentification des applications WebFacing, voir Définition des options d'authentification.

  1. Pour ouvrir les propriétés du projet WebFacing, cliquez avec le bouton droit de la souris sur le projet, sélectionnez la vue Projets WebFacing, puis cliquez sur Propriétés. Dans les paramètres du projet, le nom du système hôte du projet correspond au système contenant le registre cible.
  2. Cliquez sur l'onglet Authentification pour afficher les paramètres d'authentification.
  3. Cliquez sur le bouton d'option Utiliser l'authentification unique.
  4. Dans cet exemple, tapez la chaîne idTokenRR dans la zone Spécifier la référence de la ressource EIM, après l'avoir activée.
    Remarque : La chaîne idTokenRR importe peu. Elle est utilisée lors du mappage entre la référence de ressource et le nom de l'adaptateur réel configuré dans WAS. La chaîne est soumise à la distinction majuscules/minuscules.
  5. Cliquez sur OK pour terminer.

Ajout d'une référence de ressource dans le descripteur de déploiement Web

Mettez à jour le descripteur de déploiement Web des applications WebFacing.

  1. Dans la vue Navigateur, développez le dossier Web du projet et cliquez deux fois sur le fichier descripteur de déploiement Web (web.xml) dans le dossier WebContent\WEB-INF.
  2. Cliquez sur l'onglet Références en bas de la zone d'édition pour configurer les références de ressource.
  3. Cliquez sur Ajouter, puis sélectionnez Référence de ressource pour préciser la référence de ressource de l'application.
  4. Cliquez sur Suivant.
  5. Dans cet exemple, saisissez idTokenRR comme référence de ressource, sélectionnez javax.jms.ConnectionFactory dans la zone Type, puis sélectionnez Conteneur dans la liste Authentification.
  6. Cliquez sur Terminer.
  7. Sous Liaisons WebSphere, tapez eis/idTokenRoot comme Nom JNDI. Il s'agit du nom que vous avez précisé en configurant le mappage EIM.
  8. Enregistrez et fermez le fichier descripteur de déploiement Web.