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 :
- HTTP/1.1
- HTTPS/1.0
- HTTPS/1.1
- FTP
- FTPS
- JMS
- SMTP
- fichier-répertoire
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.
Pour créer des passerelles, procédez comme suit :
- Cliquez sur Administrateur du compte > Profils > Participant de
communauté.
- 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.
- Cliquez sur l'icône représentant une loupe pour afficher le profil du
participant.
- Cliquez sur Passerelles.
- Cliquez sur Créer. La console affiche l'écran
Caractéristiques de la passerelle.
- Si vous entendez télécharger un transfert défini par l'utilisateur,
exécutez la procédure suivante. Sinon, passez à l'étape 7.
- Cliquez sur Importer le type de transfert.
- Entrez le nom d'un fichier XML définissant le mode de transfert (ou
naviguez jusqu'au fichier par le biais du bouton
Parcourir).
- 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.
- Cliquez sur Créer.
- Entrez un nom pour identifier la passerelle. Cette zone doit être
renseignée.
- 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.
- Indiquez éventuellement si la passerelle est en ligne ou hors
ligne. Par défaut, elle est en ligne (Connecté).
- 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.
Pour créer une passerelle HTTP, procédez comme suit :
- 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
- 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é.
- 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.
- 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.
- 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.
- 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é.
- 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.
- 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.
- 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.
Pour créer une passerelle HTTPS, procédez comme suit :
- 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
- 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é.
- 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.
- 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.
- 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.
- 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é.
- 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é.
- 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.
- 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.
- 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.
Pour créer une passerelle FTP, procédez comme suit :
- 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é.
- Entrez éventuellement un nom d'utilisateur et un mot de passe si
ceux-ci s'avèrent obligatoires pour accéder au serveur FTP.
- 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.
- 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.
- 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.
- 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é.
- 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.
- 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.
- 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.
Pour créer une passerelle SMTP, procédez comme suit :
- 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
- Entrez éventuellement un nom d'utilisateur et un mot de passe si
ceux-ci s'avèrent obligatoires pour accéder au serveur HTTP.
- 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.
- 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.
- 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.
- 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é.
- 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.
- 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é.
- 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.
- 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.
Pour créer une passerelle JMS, procédez comme suit :
- 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.
- 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.
- 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.
- 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.
- 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.
- 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é.
- 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.
- 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é.
- 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.
- 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.
- Dans la zone Type de message JMS, indiquez le type de
message. Cette zone est facultative.
- 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é.
- 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.
- 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.
- 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.
- 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.
Pour créer une passerelle fichier-répertoire, procédez comme suit :
- 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
où 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>
- 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.
- 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.
- 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.
- 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é.
- 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.
- 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.
Pour créer une passerelle FTPS, procédez comme suit :
- 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é.
- 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é.
- 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.
- 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.
- 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.
- 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é.
- 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.
- 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.
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 :
- 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é.
- 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.
- Cliquez sur l'icône représentant une loupe pour afficher le profil du
participant.
- Cliquez sur Passerelles.
- Cliquez sur l'icône représentant une loupe pour afficher la
passerelle puis sur l'icône d'édition pour la modifier.
- 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.
- Exécutez une ou plusieurs des étapes ci-après pour
chaque récupérateur que vous souhaitez modifier.
- 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 .
- 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.
- 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.
- 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.
- Cliquez sur Sauvegarder.
