Configuration de passerelles pour les participants

WebSphere Business Integration Connect fait appel à des passerelles pour acheminer les documents jusqu'à leur propre destination. Les informations utilisées lors de la configuration d'une passerelle dépendent du protocole de transfert des documents sortants.

Les types de transfert pris en charge (par défaut) pour les passerelles des participants sont les suivants :

Vous pouvez également indiquer un type de transfert défini par l'utilisateur, que vous téléchargez lors de la création de la passerelle.

En tant qu'administrateur du concentrateur, vous pouvez définir les passerelles de vos participants. Vous pouvez également leur laisser le soin d'effectuer cette opération. Dans ce chapitre, vous apprendrez comment exécuter cette tâche pour les participants.

Création de passerelles

Pour créer des passerelles, procédez comme suit :

  1. Cliquez sur Administrateur du compte > Profils > Participant de communauté.
  2. Entrez les critères de recherche et cliquez sur Rechercher, ou cliquez sur Rechercher sans entrer aucun critère de recherche pour afficher la liste de tous les participants.
  3. Cliquez sur l'icône représentant une loupe pour afficher le profil du participant.
  4. Cliquez sur Passerelles.
  5. Cliquez sur Créer. La console affiche l'écran Caractéristiques de la passerelle.
  6. Si vous entendez télécharger un transfert défini par l'utilisateur, exécutez la procédure suivante. Sinon, passez à l'étape 7.
    1. Cliquez sur Importer le type de transfert.
    2. Entrez le nom d'un fichier XML définissant le mode de transfert (ou naviguez jusqu'au fichier par le biais du bouton Parcourir).
    3. Cliquez sur Télécharger.

    Remarque : Dans la liste des passerelles, vous pouvez également supprimer un type de transfert défini par l'utilisateur. Vous ne pouvez pas supprimer un transfert fourni par WebSphere Business Integration Connect. Vous ne pouvez pas non plus supprimer un transfert défini par l'utilisateur une fois qu'il a été utilisé pour la création d'une passerelle.

  7. Cliquez sur Créer.
  8. Entrez un nom pour identifier la passerelle. Cette zone doit être renseignée.
  9. Indiquez éventuellement l'état de la passerelle. L'état par défaut est Activé. Une passerelle activée est prête à envoyer des documents. Une passerelle désactivée ne peut pas envoyer de documents.
  10. Indiquez éventuellement si la passerelle est en ligne ou hors ligne. Par défaut, elle est en ligne (Connecté).
  11. Entrez éventuellement une description de la passerelle.

La procédure indiquée s'applique à toutes les passerelles. Toutefois, les options proposées à l'écran varient en fonction de la passerelle sélectionnée. Vous trouverez ci-dessous les étapes supplémentaires à exécuter pour configurer la passerelle, en fonction du type de transfert auquel elle est associée.

Sachez qu'après avoir fourni les informations relatives au type de transfert dans le but de définir une passerelle, vous pouvez également modifier les points de configuration de la passerelle.

Création d'une passerelle HTTP

Pour créer une passerelle HTTP, procédez comme suit :

  1. Dans la zone Identificateur URI de la cible, entrez l'identificateur URI de la destination du document. Cette zone doit être renseignée.

    Le format est : http://<nomserveur>:<portoptionnel>/<chemin>

    Exemple :

    http://anotherwbicserver.ibm.com:57080/bcgreceiver/Receiver
     
  2. Entrez éventuellement un nom d'utilisateur et un mot de passe si ceux-ci s'avèrent obligatoires pour accéder au serveur HTTP sécurisé.
  3. Dans la zone Nombre de relances, indiquez le nombre de fois que la passerelle doit tenter d'envoyer un document avant d'abandonner. La valeur par défaut est 3.
  4. Dans la zone Intervalle de relance, indiquez le délai d'attente que la passerelle doit observer avant de tenter de renvoyer le document. La valeur par défaut est 300 secondes.
  5. Dans la zone Nombre d'unités d'exécution, indiquez le nombre de documents qui doivent être traités simultanément. La valeur par défaut est 3.
  6. Dans la zone Validation de l'IP du client, sélectionnez Oui si vous voulez que l'adresse IP de l'expéditeur soit validée avant que le document ne soit traité. Dans le cas contraire, sélectionnez Non. Par défaut, Non est sélectionné.
  7. Dans la zone Mise en file d'attente automatique, sélectionnez Oui si vous voulez que la passerelle soit mise hors ligne (automatiquement) lorsqu'un échec de remise est sur le point de se produire après que le nombre de relances ait été épuisé. Dans le cas contraire, sélectionnez Non. Par défaut, Non est sélectionné.

    Si vous avez activé la mise en file d'attente automatique, tous les documents restent en file d'attente tant que la passerelle n'a pas été mise en ligne manuellement.

  8. Dans la zone Délai de connexion, indiquez le nombre de secondes durant lesquelles une connexion pourra rester ouverte en l'absence de trafic. La valeur par défaut est 120 secondes.
  9. Si vous souhaitez configurer l'étape preprocess (traitement préalable) ou postprocess (traitement ultérieur) pour la passerelle, consultez Modification des points de configuration pour les passerelles. Sinon, cliquez sur Sauvegarder.

Création d'une passerelle HTTPS

Pour créer une passerelle HTTPS, procédez comme suit :

  1. Dans la zone Identificateur URI de la cible, entrez l'identificateur URI de la destination du document. Cette zone doit être renseignée.

    Le format est : https://<nomserveur>:<portoptionnel>/<chemin>

    Exemple :

    https://anotherwbicserver.ibm.com:57443/bcgreceiver/Receiver
     
  2. Entrez éventuellement un nom d'utilisateur et un mot de passe si ceux-ci s'avèrent obligatoires pour accéder au serveur HTTP sécurisé.
  3. Dans la zone Nombre de relances, indiquez le nombre de fois que la passerelle doit tenter d'envoyer un document avant d'abandonner. La valeur par défaut est 3.
  4. Dans la zone Intervalle de relance, indiquez le délai d'attente que la passerelle doit observer avant de tenter de renvoyer le document. La valeur par défaut est 300 secondes.
  5. Dans la zone Nombre d'unités d'exécution, indiquez le nombre de documents qui doivent être traités simultanément. La valeur par défaut est 3.
  6. Dans la zone Validation de l'IP du client, sélectionnez Oui si vous voulez que l'adresse IP de l'expéditeur soit validée avant que le document ne soit traité. Dans le cas contraire, sélectionnez Non. Par défaut, Non est sélectionné.
  7. Dans la zone Validation du certificat SSL du client, sélectionnez Oui si vous voulez que le certificat électronique du partenaire expéditeur soit validé par rapport au numéro DUNS associé au document. Par défaut, Non est sélectionné.
  8. Dans la zone Mise en file d'attente automatique, sélectionnez Oui si vous voulez que la passerelle soit mise hors ligne (automatiquement) lorsqu'un échec de remise est sur le point de se produire après que le nombre de relances ait été épuisé. Dans le cas contraire, sélectionnez Non. Par défaut, Non est sélectionné.

    Si vous avez activé la mise en file d'attente automatique, tous les documents restent en file d'attente tant que la passerelle n'a pas été mise en ligne manuellement.

  9. Dans la zone Délai de connexion, indiquez le nombre de secondes durant lesquelles une connexion pourra rester ouverte en l'absence de trafic. La valeur par défaut est 120 secondes.
  10. Si vous souhaitez configurer l'étape preprocess (traitement préalable) ou postprocess (traitement ultérieur) pour la passerelle, consultez Modification des points de configuration pour les passerelles. Sinon, cliquez sur Sauvegarder.

Création d'une passerelle FTP

Pour créer une passerelle FTP, procédez comme suit :

  1. Dans la zone Identificateur URI de la cible, entrez l'identificateur URI de la destination du document. Cette zone doit être renseignée.

    Le format est : ftp://<nomserveur ftp>: <numéroport>

    Exemple :

    ftp://ftpserver1.ibm.com:2115
     

    Si vous ne définissez pas de numéro de port, le port FTP standard est utilisé.

  2. Entrez éventuellement un nom d'utilisateur et un mot de passe si ceux-ci s'avèrent obligatoires pour accéder au serveur FTP.
  3. Dans la zone Nombre de relances, indiquez le nombre de fois que la passerelle doit tenter d'envoyer un document avant d'abandonner. La valeur par défaut est 3.
  4. Dans la zone Intervalle de relance, indiquez le délai d'attente que la passerelle doit observer avant de tenter de renvoyer le document. La valeur par défaut est 300 secondes.
  5. Dans la zone Nombre d'unités d'exécution, indiquez le nombre de documents qui doivent être traités simultanément. La valeur par défaut est 3.
  6. Dans la zone Validation de l'IP du client, sélectionnez Oui si vous voulez que l'adresse IP de l'expéditeur soit validée avant que le document ne soit traité. Dans le cas contraire, sélectionnez Non. Par défaut, Non est sélectionné.
  7. Dans la zone Mise en file d'attente automatique, sélectionnez Oui si vous voulez que la passerelle soit mise hors ligne (automatiquement) lorsqu'un échec de remise est sur le point de se produire après que le nombre de relances ait été épuisé. Dans le cas contraire, sélectionnez Non. Par défaut, Non est sélectionné.

    Si vous avez activé la mise en file d'attente automatique, tous les documents restent en file d'attente tant que la passerelle n'a pas été mise en ligne manuellement.

  8. Dans la zone Délai de connexion, indiquez le nombre de secondes durant lesquelles une connexion pourra rester ouverte en l'absence de trafic. La valeur par défaut est 120 secondes.
  9. Si vous souhaitez configurer l'étape preprocess (traitement préalable) ou postprocess (traitement ultérieur) pour la passerelle, consultez Modification des points de configuration pour les passerelles. Sinon, cliquez sur Sauvegarder.

Création d'une passerelle SMTP

Pour créer une passerelle SMTP, procédez comme suit :

  1. Dans la zone Identificateur URI de la cible, entrez l'identificateur URI de la destination du document. Cette zone doit être renseignée.

    Le format est : mailto:<utilisateur@nomserveur>

    Exemple :

    mailto:admin@anotherwbicserver.ibm.com
     
  2. Entrez éventuellement un nom d'utilisateur et un mot de passe si ceux-ci s'avèrent obligatoires pour accéder au serveur HTTP.
  3. Dans la zone Nombre de relances, indiquez le nombre de fois que la passerelle doit tenter d'envoyer un document avant d'abandonner. La valeur par défaut est 3.
  4. Dans la zone Intervalle de relance, indiquez le délai d'attente que la passerelle doit observer avant de tenter de renvoyer le document. La valeur par défaut est 300 secondes.
  5. Dans la zone Nombre d'unités d'exécution, indiquez le nombre de documents qui doivent être traités simultanément. La valeur par défaut est 3.
  6. Dans la zone Validation de l'IP du client, sélectionnez Oui si vous voulez que l'adresse IP de l'expéditeur soit validée avant que le document ne soit traité. Dans le cas contraire, sélectionnez Non. Par défaut, Non est sélectionné.
  7. Dans la zone Mise en file d'attente automatique, sélectionnez Oui si vous voulez que la passerelle soit mise hors ligne (automatiquement) lorsqu'un échec de remise est sur le point de se produire après que le nombre de relances ait été épuisé. Dans le cas contraire, sélectionnez Non. Par défaut, Non est sélectionné.

    Si vous avez activé la mise en file d'attente automatique, tous les documents restent en file d'attente tant que la passerelle n'a pas été mise en ligne manuellement.

  8. Dans la zone Authentification obligatoire, indiquez si un nom d'utilisateur et un mot de passe doivent être fournis pour le document. Par défaut, Non est sélectionné.
  9. Dans la zone Délai de connexion, indiquez le nombre de secondes durant lesquelles une connexion pourra rester ouverte en l'absence de trafic. La valeur par défaut est 120 secondes.
  10. Si vous souhaitez configurer l'étape preprocess (traitement préalable) ou postprocess (traitement ultérieur) pour la passerelle, consultez Modification des points de configuration pour les passerelles. Sinon, cliquez sur Sauvegarder.

Création d'une passerelle JMS

Pour créer une passerelle JMS, procédez comme suit :

  1. Dans la zone Identificateur URI de la cible, entrez l'identificateur URI de la destination du document. Cette zone doit être renseignée.

    Pour WebSphere MQ JMS, le format de l'identificateur URI de la cible est le suivant :

    file:///<chemin_liaisons_JNDI_MQ_défini_utilisateur>
     

    Exemple :

    file:///opt/JNDI-Directory
     

    Le répertoire contient le fichier " .bindings" (liaisons) pour le JNDI à partir de fichiers. Ce fichier indique à WebSphere Business Integration Connect comment acheminer le document à destination.

    Pour ses passerelles, le participant fournira sans doute le fichier ".bindings". Des passerelles JMS internes (telles que la passerelle du Gestionnaire de communauté) peuvent être créées à l'aide de JMSAdmin comme indiqué dans Etapes préalables à la configuration du concentrateur.

    Cette zone doit être renseignée.

  2. Entrez éventuellement un nom d'utilisateur et un mot de passe si ceux-ci s'avèrent obligatoires pour accéder à la file d'attente JMS.
  3. Dans la zone Nombre de relances, indiquez le nombre de fois que la passerelle doit tenter d'envoyer un document avant d'abandonner. La valeur par défaut est 3.
  4. Dans la zone Intervalle de relance, indiquez le délai d'attente que la passerelle doit observer avant de tenter de renvoyer le document. La valeur par défaut est 300 secondes.
  5. Dans la zone Nombre d'unités d'exécution, indiquez le nombre de documents qui doivent être traités simultanément. La valeur par défaut est 3.
  6. Dans la zone Validation de l'IP du client, sélectionnez Oui si vous voulez que l'adresse IP de l'expéditeur soit validée avant que le document ne soit traité. Dans le cas contraire, sélectionnez Non. Par défaut, Non est sélectionné.
  7. Dans la zone Mise en file d'attente automatique, sélectionnez Oui si vous voulez que la passerelle soit mise hors ligne (automatiquement) lorsqu'un échec de remise est sur le point de se produire après que le nombre de relances ait été épuisé. Dans le cas contraire, sélectionnez Non. Par défaut, Non est sélectionné.

    Si vous avez activé la mise en file d'attente automatique, tous les documents restent en file d'attente tant que la passerelle n'a pas été mise en ligne manuellement.

  8. Dans la zone Authentification obligatoire, indiquez si un nom d'utilisateur et un mot de passe doivent être fournis pour le document. Par défaut, Non est sélectionné.
  9. Dans la zone Nom de la fabrique JMS, indiquez le nom de la classe Java qu'utilise le fournisseur JMS pour se connecter à la file d'attente JMS. Cette zone doit être renseignée.
  10. Dans la zone Classe de message JMS, entrez la classe de message. Toutes les classes de message JMS valides peuvent être sélectionnées, telles que TextMessage ou BytesMessage. Cette zone doit être renseignée.
  11. Dans la zone Type de message JMS, indiquez le type de message. Cette zone est facultative.
  12. Dans la zone Modules d'URL du fournisseur, entrez le nom des classes (ou du fichier JAR) utilisées par Java pour comprendre l'URL de contexte JMS. Cette zone est facultative. Si vous ne définissez pas de valeur, le chemin au fichier de liaisons est utilisé.
  13. Dans la zone Nom de file d'attente JMS, entrez le nom de la file d'attente JMS vers laquelle les documents doivent être envoyés. Cette zone doit être renseignée.
  14. Dans la zone Nom de la fabrique du JNDI du JMS, indiquez le nom de la fabrique utilisée pour se connecter au service désigné. Cette zone doit être renseignée. Vous utiliserez probablement la valeur com.sun.jndi.fscontext.RefFSContextFactory, si vous définissez votre configuration JMS comme indiqué dans Etapes préalables à la configuration du concentrateur.
  15. Dans la zone Délai de connexion, indiquez le nombre de secondes durant lesquelles une connexion pourra rester ouverte en l'absence de trafic. La valeur par défaut est 120 secondes.
  16. Si vous souhaitez configurer l'étape preprocess (traitement préalable) ou postprocess (traitement ultérieur) pour la passerelle, consultez Modification des points de configuration pour les passerelles. Sinon, cliquez sur Sauvegarder.

Création d'une passerelle fichier-répertoire

Pour créer une passerelle fichier-répertoire, procédez comme suit :

  1. Dans la zone Identificateur URI de la cible, entrez l'identificateur URI de la destination du document. Cette zone doit être renseignée.

    Pour les systèmes UNIX et Windows dans lesquels le répertoire de fichiers et WebSphere Business Integration Connect sont situés sur la même unité, le format est : file:///<chemin au répertoire cible>

    Exemple :

    file:///localfiledir 
     

    localfiledir est un répertoire du répertoire racine.

    Pour les systèmes Windows dans lesquels le répertoire de fichiers et WebSphere Business Integration Connect sont situés sur des unités distinctes, le format est : file:///<lettre unité>:/<chemin>

  2. Dans la zone Nombre de relances, indiquez le nombre de fois que la passerelle doit tenter d'envoyer un document avant d'abandonner. La valeur par défaut est 3.
  3. Dans la zone Intervalle de relance, indiquez le délai d'attente que la passerelle doit observer avant de tenter de renvoyer le document. La valeur par défaut est 300 secondes.
  4. Dans la zone Nombre d'unités d'exécution, indiquez le nombre de documents qui doivent être traités simultanément. La valeur par défaut est 3.
  5. Dans la zone Validation de l'IP du client, sélectionnez Oui si vous voulez que l'adresse IP de l'expéditeur soit validée avant que le document ne soit traité. Dans le cas contraire, sélectionnez Non. Par défaut, Non est sélectionné.
  6. Dans la zone Mise en file d'attente automatique, sélectionnez Oui si vous voulez que la passerelle soit mise hors ligne (automatiquement) lorsqu'un échec de remise est sur le point de se produire après que le nombre de relances ait été épuisé. Dans le cas contraire, sélectionnez Non. Par défaut, Non est sélectionné.

    Si vous avez activé la mise en file d'attente automatique, tous les documents restent en file d'attente tant que la passerelle n'a pas été mise en ligne manuellement.

  7. Si vous souhaitez configurer l'étape preprocess (traitement préalable) ou postprocess (traitement ultérieur) pour la passerelle, consultez Modification des points de configuration pour les passerelles. Sinon, cliquez sur Sauvegarder.

Création d'une passerelle FTPS

Pour créer une passerelle FTPS, procédez comme suit :

  1. Dans la zone Identificateur URI de la cible, entrez l'identificateur URI de la destination du document. Cette zone doit être renseignée.

    Le format est : ftp://<nomserveur ftp>:<numéroport>

    Exemple :

    ftp://ftpserver1.ibm.com:2115
     

    Si vous ne définissez pas de numéro de port, le port FTP standard est utilisé.

  2. Entrez éventuellement un nom d'utilisateur et un mot de passe si ceux-ci s'avèrent obligatoires pour accéder au serveur HTTP sécurisé.
  3. Dans la zone Nombre de relances, indiquez le nombre de fois que la passerelle doit tenter d'envoyer un document avant d'abandonner. La valeur par défaut est 3.
  4. Dans la zone Intervalle de relance, indiquez le délai d'attente que la passerelle doit observer avant de tenter de renvoyer le document. La valeur par défaut est 300 secondes.
  5. Dans la zone Nombre d'unités d'exécution, indiquez le nombre de documents qui doivent être traités simultanément. La valeur par défaut est 3.
  6. Dans la zone Validation de l'IP du client, sélectionnez Oui si vous voulez que l'adresse IP de l'expéditeur soit validée avant que le document ne soit traité. Dans le cas contraire, sélectionnez Non. Par défaut, Non est sélectionné.
  7. Dans la zone Mise en file d'attente automatique, sélectionnez Oui si vous voulez que la passerelle soit mise hors ligne (automatiquement) lorsqu'un échec de remise est sur le point de se produire après que le nombre de relances ait été épuisé. Dans le cas contraire, sélectionnez Non. Par défaut, Non est sélectionné.

    Si vous avez activé la mise en file d'attente automatique, tous les documents restent en file d'attente tant que la passerelle n'a pas été mise en ligne manuellement.

  8. Si vous souhaitez configurer l'étape preprocess (traitement préalable) ou postprocess (traitement ultérieur) pour la passerelle, consultez Modification des points de configuration pour les passerelles. Sinon, cliquez sur Sauvegarder.

Remarque : Pour qu'un passerelle FTPS externe fonctionne correctement, vous devez au moins charger le certificat de CA du serveur FTPS dans le profil de l'Opérateur de concentrateur en tant que certificat racine. (Pour charger un certificat, cliquez sur Administrateur du compte > Profils > Certificats .) Lors du chargement de ce certificat, WebSphere Business Integration Connection sécurisera le certificat du serveur FTPS.

Si le serveur FTPS nécessite également une authentification client, vous devez disposer d'un certificat client chargé dans le profil de l'Opérateur de concentrateur en tant que certificat SSL. WebSphere Business Integration Connect fournit ce certificat au serveur FTPS. Le serveur FTPS du participant doit être configuré pour sécuriser votre certificat.

Pour plus d'informations concernant la sécurité, voir Configuration de la sécurité pour les échanges entrants et sortants.

Modification des points de configuration pour les passerelles

Comme indiqué dans Introduction, vous pouvez modifier deux points de configuration pour une passerelle -- Preprocess et Postprocess.

Pour appliquer un récupérateur écrit par l'utilisateur à ces points de configuration, vous devez d'abord télécharger le récupérateur, comme décrit dans la section Téléchargement de récupérateurs définis par l'utilisateur. Vous pouvez également utiliser un récupérateur fourni par le système, déjà disponible et qu'il n'est pas nécessaire de télécharger.

Pour modifier un point de configuration :

  1. Si vous êtes sur le point de créer une passerelle, passez à l'étape 6. Si vous mettez à jour une configuration de passerelle, cliquez sur Administrateur du compte > Profils > Participant de communauté.
  2. Entrez les critères de recherche et cliquez sur Rechercher, ou cliquez sur Rechercher sans entrer aucun critère de recherche pour afficher la liste de tous les participants.
  3. Cliquez sur l'icône représentant une loupe pour afficher le profil du participant.
  4. Cliquez sur Passerelles.
  5. Cliquez sur l'icône représentant une loupe pour afficher la passerelle puis sur l'icône d'édition pour la modifier.
  6. Dans la liste Récupérateurs des points de configuration, sélectionnez le point de configuration à modifier. Les points de configuration pouvant être modifiés sont Preprocess et Postprocess.
  7. Exécutez une ou plusieurs des étapes ci-après pour chaque récupérateur que vous souhaitez modifier.
    1. Ajoutez un récupérateur en le sélectionnant dans la liste des récupérateurs disponibles et en cliquant sur Ajouter. Le récupérateur passe dans la liste des récupérateurs configurés.

      Remarque : WebSphere Business Integration Connect ne fournit pas de récupérateur de passerelle par défaut. Les récupérateurs qui apparaissent dans la liste récupérateurs disponibles sont uniquement ceux que vous avez téléchargés .

    2. Pour supprimer un récupérateur, sélectionnez-le dans la liste des récupérateurs configurés et cliquez sur Supprimer. Le récupérateur passe dans la liste des récupérateurs disponibles.
    3. Pour modifier l'ordre du récupérateur dans la liste, sélectionnez-le dans la liste et cliquez sur le bouton de déplacement vers le haut ou déplacement vers le bas.
    4. Pour configurer le récupérateur, sélectionnez-le dans la liste des récupérateurs configurés et cliquez sur Configurer. La liste des attributs pouvant être configurés s'affiche.
  8. Cliquez sur Sauvegarder.

Copyright IBM Corp. 1997, 2004