Gestion des configurations de passerelle

Les passerelles vous permettent de gérer les informations de transfert utilisées pour l'acheminement des documents vers leur destination propre dans la communauté de concentrateur. Le protocole de transfert sortant détermine les informations utilisées pendant la configuration des passerelles. Pour plus d'informations sur la création de passerelles, voir le manuel Guide de configuration du concentrateur.

Informations requises pour la configuration de la passerelle

Le type de transfert détermine les informations de paramètre requises pour la configuration de la passerelle. Dans le tableau 3, les cases contenant la lettre X nécessitent des informations de configuration et celles contenant la lettre O sont facultatives. Voir tableau 4 pour les descriptions de paramètre de passerelle.

Remarque :
La possibilité de modifier certaines valeurs liées à la configuration de la passerelle varie en fonction du niveau d'autorisation de l'utilisateur.
Tableau 3. Informations de transfert requises
Informations de transfert requises Transfert HTTP Transfert HTTPS Transfert FTP Transfert FTPS Transfert de scripts FTP Transfert de répertoires de fichier Transfert JMS Transfert SMTP

Authentifi-cation
Obligatoire

O

O

Mise en file d'attente automatique

O

O

O

O

O

O

Connexion
Délai

X

X

X

X

X

Mode FTPS

O

Fabrique JMS
Name

X

JNDI du JMS
Factory
Name

X

Message JMS
Classe

X

Message JMS
Type

O

File d'attente JMS
Name

X

Verrouiller utilisateur

O

Nombre de
Unités d'exécution

X

X

X

X

X

X

Mot de passe

O

O

O

O

O

O

O

O

Fournisseur
Module URL

O

Nombre de relances

X

X

X

X

X

X

X

X

Intervalle de relance

X

X

X

X

X

X

X

X

Adresse IP du serveur

X

Identificateur URI de la cible

X

X

X

X

X

X

X

ID utilisateur

O

Nom d'utilisateur

O

O

O

O

O

O

O

Validation
IP du client

O

O

O

O

Validation
Certificat SSL
Client

O

Remarques :
  1. Lorsque l'option Authentification obligatoire d'une passerelle est activée et que le nom d'utilisateur et le mot de passe sont fournis, la passerelle transmet le nom d'utilisateur et le mot de passe au système externe auquel elle se connecte pour la sortie du document. La passerelle n'applique pas l'authentification ; elle se contente de transmettre ces justificatifs d'authentification au système auquel elle tente de se connecter. Pour une passerelle JMS, le nom d'utilisateur et le mot de passe sont utilisés comme autorisation d'accès pour la recherche JNDI de la fabrique de connexion de file d'attente JMS. Notez que JMS sur Websphere MQ n'applique pas l'authentification JNDI lorsque le JNDI basé sur les fichiers est utilisé pour la connexion à une file d'attente JMS.
  2. Un nom d'utilisateur et un mot de passe sont requis pour l'authentification FTPS, sauf si vous négociez avec un serveur FTPS authentifiant l'utilisateur par la présentation d'un certificat de client. Pour plus de détails sur la mise en oeuvre, adresses-vous à l'administrateur du serveur FTPS.

Affichage et modification des passerelles

Pour afficher et modifier les passerelles, procédez comme suit :

  1. Cliquez sur Administrateur du compte > Profils > Passerelles.
  2. Cliquez sur En ligne ou Hors ligne dans la colonne Accès pour changer l'accès à une passerelle.
  3. Cliquez sur Activé ou Désactivé dans la colonne Etat pour modifier l'état d'une passerelle.
  4. Cliquez sur l'icône Afficher les détails pour afficher les caractéristiques de la passerelle.
  5. Cliquez sur l'icône d'édition.
  6. Dans la fenêtre Caractéristiques de la passerelle, modifiez les paramètres de la passerelle décrits ci-après : tableau 4.
  7. Cliquez sur Sauvegarder.

    Vous pouvez également supprimer la passerelle en cliquant sur Supprimer.

    Tableau 4. Descriptions des paramètres de la passerelle
    Paramètre Description

    Authentification obligatoire

    Si vous activez ce paramètre, le nom d'utilisateur et le mot de passe sont fournis avec les messages JMS ou SMTP.

    Mise en file d'attente automatique

    Lorsque vous activez ce paramètre, les documents sont placés dans un référentiel temporaire si la passerelle est mise hors ligne. Si vous ne l'activez pas et que la passerelle est mise hors ligne, le document n'est pas acheminé et une erreur se produit.

    Planification en fonction du calendrier

    Lorsque cette option est sélectionnée, les documents associés à cette passerelle sont traités en fonction de la planification sélectionnée.

    Gestionnaires de paramètres de configuration

    Utilisés pour spécifier quels récupérateurs sont utilisés pour le préprocess et le postprocess.

    Délai de connexion

    Nombre de secondes pendant lesquelles une connexion reste ouverte sans trafic. La valeur par défaut est de 120 (2 minutes).

    Description

    Description facultative de la passerelle.

    Mode FTPS

    Sélectionnez Oui ou Non pour contrôler si une connexion sécurisée est utilisée.

    Nom de la passerelle

    Nom utilisé pour identifier la passerelle.

    Remarque : la zone Nom de la passerelle est une zone de format libre définie par l'utilisateur. Même s'il n'est pas obligatoire que le nom soit unique, les utilisateurs devraient utiliser des noms différents pour des passerelles individuelles afin d'éviter une confusion potentielle.

    Planification en fonction de l'intervalle

    Lorsque cette option est sélectionnée, la passerelle traite le document à l'intervalle de temps spécifié.

    Nom de la fabrique JMS

    Nom de la classe Java que le fournisseur JMS utilisera pour établir une connexion à la file d'attente JMS.

    Nom de la fabrique du JNDI du JMS

    Nom de la fabrique utilisé pour la connexion au service annuaire.

    Classe de message JMS

    Classe de message.

    Type de message JMS

    Type de message JMS.

    Nom de file d'attente JMS

    Nom de la file d'attente dans laquelle les messages JMS sont stockés.

    Intervalle entre relances de verrouillage (Secondes)

    Durée pendant laquelle le composant script FTP attendra entre des tentatives de relances de verrouillage.

    Nombre de relances du verrouillage

    Nombre de fois que le composant script FTP tentera d'obtenir le verrouillage.

    Verrouiller utilisateur

    Sélectionnez Oui ou Non pour contrôler si oui ou non des connexions simultanées sont autorisées.

    Délai maximal de verrouillage (secondes)

    Durée maximale pendant laquelle le composant script FTP maintiendra le verrouillage. Après la durée maximale, le verrouillage est renvoyé à la base de données.

    Délai maximal des files d'attente (secondes)

    Durée maximale pendant laquelle le composant script FTP reste dans la file d'attente de requête de verrouillage. Il est placé dans la file d'attente de requête de verrouillage lorsque la requête de verrouillage a été refusée.

    Nombre d'unités d'exécution

    Nombre d'unités d'exécution allouées à l'acheminement d'un document. La valeur par défaut est de 3. Ce paramètre est disponible pour les utilisateurs Administrateur du concentrateur uniquement.

    En ligne/Hors ligne

    Indique si la passerelle est en ligne ou hors ligne. Si elle est hors ligne, les documents sont mis en file d'attente jusqu'à ce que la passerelle soit en ligne.

    Mot de passe

    Mot de passe pour l'accès sécurisé à travers le pare-feu du participant.

    Module URL du fournisseur

    Nom des classes ou du fichier JAR que Java utilise pour comprendre l'URL de contexte JMS.

    Nombre de relances

    Nombre maximal de tentatives d'envoi d'un document par le système avant d'abandonner. La valeur par défaut est de 3.

    Intervalle de relance

    Durée que la passerelle devrait attendre entre deux tentatives de relance. La valeur par défaut est de 300 (5 minutes).

    Fichier Script

    Le script FTP qui contient les commandes FTP.

    Adresse IP du serveur

    Adresse IP du serveur.

    Etat

    Indique si la passerelle est activée ou désactivée. Si elle est désactivée, le traitement des documents qui passent par la passerelle échoue.

    Identificateur URI de la cible

    URI (Uniform Resource Identifier) du participant.

    Nombre d'unités d'exécution

    Nombre de documents qui doivent être traités simultanément.

    Transfert

    Protocole d'acheminement des documents (voir Informations requises pour la configuration de la passerelle).

    Utiliser un nom de fichier unique

    Crée un nom de fichier unique lorsque le document est reçu à l'emplacement cible. Le nom d'origine du fichier est stocké dans la base de données.

    Attributs définis par l'utilisateur

    Pour les fichiers script FTP, les utilisateurs peuvent ajouter leurs propres attributs, qui peuvent être définis dans la console. Ces attributs sont lus à la passerelle puis remplacés dans le fichier script.

    ID utilisateur

    Obligatoire pour accéder au serveur FTP.

    Nom d'utilisateur

    Nom d'utilisateur pour l'accès sécurisé à travers le pare-feu du participant.

    Validation de l'IP du client

    Valide l'adresse IP de l'expéditeur avant le traitement du document. Utilisée avec la passerelle sélectionnée comme passerelle source pour une connexion.

    Validation du certificat SSL du client

    Valide le certificat numérique du participant à l'origine de l'envoi par rapport au numéro DUNS associé au document avant de traiter le document. Utilisée avec la passerelle sélectionnée comme passerelle source pour une connexion.

Affichage et modification des passerelles par défaut

Pour afficher les passerelles par défaut configurées pour le système et les modifier, procédez comme suit :

  1. Cliquez sur Administrateur du compte > Profils > Passerelles.
  2. Cliquez sur Afficher les passerelles par défaut dans le coin supérieur droit de la fenêtre. La Console affiche la liste de tous les types de passerelle avec leur passerelle associée.
  3. Pour afficher les informations associées à une passerelle par défaut, cliquez sur l'icône Afficher les détails en regard de la passerelle.
  4. Modifiez les informations en conséquence, puis cliquez sur Sauvegarder.

Suppression de configurations de passerelle

Si vous n'avez plus besoin d'une configuration de passerelle, suivez la procédure suivante pour la supprimer. Aucun message d'avertissement n'apparaît lorsque vous supprimez une configuration de passerelle. Par conséquent, assurez-vous que vous n'avez plus besoin de la configuration de passerelle avant de la supprimer.

  1. Cliquez sur Administrateur du compte > Profils > Passerelles.
  2. Cliquez sur l'icône Afficher les détails en regard de la passerelle que vous souhaitez supprimer.
  3. Cliquez sur l'icône d'édition.
  4. Cliquez sur Supprimer.

Téléchargement des transferts

Suivez la procédure ci-dessous pour télécharger un transfert.

  1. Cliquez sur Administrateur du compte > Profils > Passerelles.
  2. Sélectionnez Gérer les types de transfert.
  3. Cliquez sur Parcourir et sélectionnez le transfert.
  4. Sélectionnez la validation ou non du nouveau transfert dans la base de données.
  5. Sélectionnez la réécriture ou non des données existantes.
  6. Cliquez sur Télécharger.

Suppression des transferts

Si vous n'avez plus besoin d'une configuration de transfert, procédez comme suit pour la supprimer.

  1. Cliquez sur Administrateur du compte > Profils > Passerelles.
  2. Sélectionnez Gérer les types de transfert.
  3. Cliquez sur l'icône de suppression en regard des transferts listés.

Reprises liées aux passerelles et aux transferts

Lorsque la sortie d'un document vers une passerelle du participant échoue, WebSphere Partner Gateway tente à nouveau de livrer le document. Chaque tentative est appelée une reprise. La fonctionnalité de reprise existe à deux niveaux dans WebSphere Partner Gateway : le transfert et la passerelle.

Reprises relatives au transfert

Les reprises relatives au transfert sont des reprises de bas niveau intégrées qui sont toujours appliquées, quelles que soient les spécifications de la passerelle. La raison de l'utilisation des reprises de bas niveau est que les défaillances temporaires sont inhérentes aux réseaux sur lesquels la tentative de sortie est exécutée, notamment sur Internet. Ainsi, le système de livraison est conçu pour exécuter automatiquement une reprise sans demander à l'utilisateur de définir les paramètres de reprise de manière explicite. Le nombre de reprises de transferts (bcg.delivery.gwTransportMaxRetries) et l'intervalle entre les reprises ((bcg.delivery.gwTransportRetryInterval) sont définis dans le fichier bcg.properties du gestionnaire de documents et s'appliquent à toutes les passerelles. Les valeurs par défaut sont trois reprises à des intervalles de trois secondes.

Reprises relatives aux passerelles (également appelées reprises de document)

Les paramètres relatifs aux reprises de passerelle (le nombre de reprises autorisées et l'intervalle entre les reprises) sont configurés par l'utilisateur dans les propriétés de la passerelle. En général, l'intervalle de reprise pour la passerelle est plus long que celui des reprises de transfert intégrées. L'objectif est de laisser à l'utilisateur suffisamment de temps pour corriger l'incident qui empêche la sortie. Par exemple, il est possible que le serveur Web de destination soit arrêté ou que l'URL de destination soit incorrecte. La définition des valeurs des paramètres nécessite que l'utilisateur affecte des valeurs à chaque passerelle.

Pour chaque reprise de passerelle (définie par l'utilisateur), WebSphere Partner Gateway exécute automatiquement les reprises de transfert. Par exemple, si trois reprises de passerelle sont indiquées, le modèle de reprise du système est le suivant :

Chaque échec de sortie génère un événement d'avertissement visible dans la Console de communauté.

Prise en charge du proxy direct

Pour les transferts HTTP et HTTPS, vous pouvez définir une prise en charge de serveurs proxy directs de sorte que les documents soient envoyés via un serveur proxy direct configuré. Avec WebSphere Partner Gateway, vous pouvez définir les types de prises en charge suivantes :

Une fois que vous avez défini un proxy direct, vous pouvez le rendre global pour le transfert le définissant comme passerelle de proxy direct par défaut (par exemple, toutes les passerelles HTTP utiliseront le proxy direct). Pour chacune des passerelles, vous pouvez choisir de ne pas utiliser le serveur proxy par défaut ou vous pouvez choisir d'utiliser un autre proxy direct. Pour plus d'informations sur les serveurs proxy directs, voir le manuel Guide de configuration du concentrateur.

Copyright IBM Corp. 2003, 2005