Configuration du serveur FTP pour la réception de documents

Remarque : Cette section concerne uniquement la réception de documents via FTP ou FTPS provenant de participants. L'envoi de documents à des participants est décrite dans Configuration d'une passerelle FTP et Configuration d'une passerelle FTPS.

Si vous avez l'intention d'utiliser le protocole de transfert FTP ou FTPS pour les documents entrants, vous devez installer un serveur FTP. Si vous envisagez d'utiliser le protocole FTP mais que vous n'avez pas encore installé de serveur, installez-en un avant de poursuivre. Assurez-vous que l'une des conditions ci-après s'applique à votre installation :

Configuration de la structure de répertoire requise sur le serveur FTP

Après avoir installé le serveur FTP, l'étape suivante consiste à créer la structure de répertoires requise sous le répertoire principal du serveur FTP. WebSphere Partner Gateway requiert une structure de répertoires précise pour permettre aux composants Réceptionnaire et Gestionnaire de documents d'identifier correctement le participant qui envoie le document entrant. La structure est décrite à la figure 15.

Figure 15. Structure de répertoire FTP
Cette figure montre une structure de répertoire FTP et les dossiers requis, qui sont décrits dans les paragraphes suivants

Le répertoire de chaque participant contient un répertoire Binary et un répertoire Documents. Chacun de ces deux répertoires contient un répertoire Production et un répertoire Test.

Le répertoire Documents est utilisé lorsqu'un participant envoie un document XML contenant des informations d'acheminement complètes (via FTP) vers le concentrateur. Il convient dans ce cas de créer une définition XML personnalisée.

Le répertoire Binary est utilisé lorsqu'un participant envoie tout autre document (via FTP) au concentrateur.

Pour chaque participant appelé à envoyer ou recevoir des documents via FTP, vous devez créer les dossiers suivants à partir du répertoire racine de votre serveur FTP :

  1. Créez un dossier pour chaque participant.
    Remarque : Le nom du dossier doit être identique à celui indiqué dans la zone Nom de connexion de l'entreprise lors de la création du participant. Cette procédure est décrite à la section Création des profils des participants.
  2. Sous ce dossier, créez les sous-dossiers Binary et Documents.
  3. Sous les dossiers Binary et Documents, créez les sous-dossiers Production et Test.

Traitement des fichiers envoyés par FTP

Il est important de comprendre comment les fichiers binaires et XML sont traités par le serveur FTP.

Fichiers binaires

Les noms de fichiers binaires doivent être structurés selon un modèle précis, car les fichiers ne sont pas du tout inspectés par le Gestionnaire de documents.

La structure des noms de fichiers est : <ID_participant_destinataire><Nom_fichier_unique>

Lorsqu'un fichier binaire est détecté par le Réceptionnaire, il est écrit dans la mémoire partagée puis transmis au Gestionnaire de documents en vue de son traitement.

Le nom du répertoire dans lequel le fichier a été détecté identifie le nom du participant d'origine, tandis que la première partie du nom du fichier identifie le nom du participant de destination. Par ailleurs, la position du répertoire dans l'arborescence permet de déterminer s'il s'agit d'une transaction de Production ou de Test.

Par exemple, un fichier nommé 123456789.abcdefg1234567 est détecté dans le répertoire \ftproot\partenaireB\binary\production. Le Gestionnaire de documents a pris connaissance des informations suivantes :

Le Gestionnaire de documents recherche ensuite une connexion de participants de production entre le partenaireB et le partenaireA pour :

Le Gestionnaire de documents traite alors le fichier.

Fichiers XML

Un fichier XML n'obéit à aucune règle d'appellation de fichiers car il est inspecté par le Gestionnaire de documents et les informations d'acheminement sont extraites du document lui-même.

Lorsqu'un fichier XML est détecté par le Réceptionnaire, il est écrit dans la mémoire partagée puis transmis au Gestionnaire de documents en vue de son traitement.

Le Gestionnaire de documents compare le fichier XML aux formats XML définis et sélectionne le format XML qui convient. (Le paramétrage des formats XML est décrit dans la section Création de documents XML personnalisés.) Le nom du Participant d'origine, le nom du Participant de destination et les informations d'acheminement sont extraits du fichier XML.

Par ailleurs, la position du répertoire dans l'arborescence permet de déterminer s'il s'agit d'une transaction de Production ou de Test.

Le Gestionnaire de documents utilise alors ces informations pour localiser la connexion de participants correspondante avant de traiter le fichier.

Configuration supplémentaire du serveur FTP

Après avoir créé la structure de répertoires requise, vous devez configurer votre serveur FTP pour chaque participant de la communauté du concentrateur. La façon dont vous allez configurer le serveur FTP dépend du serveur que vous utilisez. Consultez la documentation du serveur FTP, puis effectuez les opérations suivantes :

  1. Ajoutez un nouveau groupe (par exemple, Participants).
  2. Ajoutez un utilisateur au groupe nouvellement créé pour chaque participant appelé à envoyer ou recevoir des documents via FTP.
  3. Pour chaque participant, configurez le serveur FTP pour mapper le participant entrant sur la structure de répertoire respective que vous avez créée pour le participant dans la section précédente Configuration de la structure de répertoire requise sur le serveur FTP. Pour plus d'informations, reportez-vous à la documentation relative à votre serveur FTP.

Considérations relatives à la sécurité du serveur FTP

Si vous utilisez un serveur FTPS pour recevoir des documents, les considérations relatives à la sécurité pour les sessions SSL sont gérées uniquement par le serveur FTPS et le client utilisés par le participant. Il n'existe pas de configuration de sécurité spécifique à WebSphere Partner Gateway pour les documents FTPS entrants. WebSphere Partner Gateway extrait les documents de la cible FTP (décrite dans Définition d'une cible FTP) une fois que le serveur a négocié les canaux sécurisés et reçu le document. Pour configurer un canal sécurisé qui puisse être contacté par un participant, reportez-vous à la documentation relative au serveur FTPS pour connaître les certificats requis (et où ils sont nécessaires).

Pour authentifier le serveur, fournissez le certificat du réceptionnaire aux participants. Si ce certificat est fourni par une Autorité de certification, fournissez également la chaîne de certificat de CA. Si l'authentification de client est prise en charge par le serveur FTPS, les certificats d'authentification client des participants doivent être précisés sur le serveur FTPS. Consultez la documentation du serveur FTPS pour obtenir des informations sur l'authentification client et les certificats.

Copyright IBM Corp. 2003, 2005