Partager via

Configuration de l’adaptateur FTP

Avant de commencer

  • L’adaptateur FTP prend en charge la lecture et l’écriture de données à partir d’un serveur FTP sécurisé. L’adaptateur prend en charge le transfert de fichiers à partir d’un serveur FTP via SSL (Secure Sockets Layer)/TLS (Transport Level Security).
  • L’adaptateur FTP prend en charge le téléchargement de fichiers à partir d’emplacements de fichiers en lecture seule.
  • L’adaptateur FTP prend également en charge le transfert de fichiers atomiques pour le mode ASCII.

Consultez les meilleures pratiques et recommandations relatives à l’adaptateur FTP.

Configurer l’emplacement de réception

Vous pouvez définir les propriétés de l’adaptateur d’emplacement de réception FTP dans la console Administration de BizTalk Server. Si les propriétés ne sont pas définies à l’emplacement de réception, les valeurs de gestionnaire de réception par défaut dans la console Administration de BizTalk Server sont utilisées.

Remarque

Avant d’effectuer la procédure suivante, vous devez avoir déjà ajouté un port de réception. Découvrez comment créer un port de réception.

  1. Dans la console Administration de BizTalk Server, développez Administration bizTalk Server, développez Groupe BizTalk, développez Applications, puis développez l’application dans laquelle vous souhaitez créer un emplacement de réception.

  1. Dans le volet gauche, cliquez sur le nœud Ports de réception . Dans le volet droit, cliquez avec le bouton droit sur le port de réception associé à un emplacement de réception existant ou que vous souhaitez associer à un nouvel emplacement de réception, puis cliquez sur Propriétés.

  2. Dans la boîte de dialogue Propriétés du port de réception , dans le volet gauche, sélectionnez Emplacements de réception. Dans le volet droit, double-cliquez sur un emplacement de réception existant ou cliquez sur Nouveau pour créer un emplacement de réception.

  3. Dans la boîte de dialogue Propriétés de l’emplacement de réception , dans la section Transport en regard de Type, sélectionnez FTP dans la liste déroulante, puis cliquez sur Configurer.

  4. Dans les propriétés de transport FTP, procédez comme suit :

    Lot

    Utiliser cette option Pour ce faire
    Nombre maximal de fichiers Spécifiez le nombre maximal de fichiers par lot BizTalk Server.

    Zéro (0) indique aucune limite.

    Valeur par défaut : 0
    Taille maximale Spécifiez le nombre maximal d’octets par lot BizTalk Server.

    Zéro (0) indique aucune limite.

    Valeur par défaut : 0

    Pare-feu

    Utiliser cette option Pour ce faire
    Adresse Spécifiez l’adresse du pare-feu, soit un nom DNS, soit une adresse IP.
    Mode Spécifiez le mode dans lequel l’adaptateur se connecte au serveur FTP.

    Valeurs valides : Passif et actif

    En mode actif, le serveur FTP se connecte à un port ouvert par l’adaptateur FTP. En mode passif, l’adaptateur FTP se connecte à un port ouvert par le serveur FTP. Le mode actif peut ne pas fonctionner si vous utilisez une adresse IP interne et que vous vous connectez à une adresse IP externe. Dans ce cas, vous devez utiliser le mode passif ou le mode actif avec une passerelle de couche application (ALG) avec compatibilité FTP.

    Valeur par défaut: Actif
    Mot de passe Spécifiez le mot de passe du pare-feu.
    Port Spécifiez le port du pare-feu.

    Valeurs valides : 1 à 65535 inclus

    Valeur par défaut : 21
    Type Spécifiez le type de pare-feu déployé.

    Valeurs valides : Aucun, Chaussettes 4 et Chaussettes 5

    Valeur par défaut: Aucun
    Utilisateur Spécifiez le nom d’utilisateur du pare-feu.

    FTP

    Utiliser cette option Pour ce faire
    Compte Spécifiez le nom du compte pour le serveur FTP. Cette option est déconseillée et l’utilisation de cette propriété est déconseillée.
    Après la réception Spécifiez les commandes FTP à exécuter après le fichier GET. Séparez les commandes avec un point-virgule (;).
    Avant de commencer Spécifiez les commandes FTP à exécuter avant le fichier GET. Séparez les commandes avec un point-virgule (;). Note: La commande QUIT n’est pas prise en charge avant le fichier GET.
    Seuil d’erreur Spécifiez le nombre d’erreurs que BizTalk Server peut rencontrer avant la désactivation de l’emplacement.

    Valeur par défaut : 10
    Masque de fichier Spécifiez le filtre de masque de fichier à utiliser lors de la transmission de fichiers.
    Dossier Spécifiez l’emplacement d’interrogation sur le serveur FTP.
    Type de serveur FTP Nouveautés à partir de BizTalk Server 2016.

    Utilisez cette propriété pour choisir un serveur FTP qui ne nécessite pas la commande SYST. Les options sont None, AIX, Detect, GXS, MVS, OS400 et Other.

    Si la valeur est None, la commande SYST est utilisée. L’autre est utilisée lorsque le type de système d’exploitation ne correspond à aucune des catégories spécifiées.

    Valeur par défaut: Aucun
    Journal Spécifiez le chemin d’accès complet, y compris le nom de fichier journal vers lequel effectuer la sortie. Vous utilisez ce fichier pour diagnostiquer les conditions d’erreur lors de l’envoi ou de la réception de fichiers via FTP.
    Taille maximale du fichier Spécifiez la taille maximale de fichier téléchargeable, en mégaoctets.

    Zéro (0) n’indique aucune limite sur la taille du fichier.

    Valeur par défaut : 100
    Mot de passe Spécifiez le mot de passe de l’utilisateur pour vous connecter au serveur FTP.
    Port Spécifiez l’adresse de port de ce serveur FTP.

    Valeur par défaut : 21
    Représentation Sélectionnez la façon dont FTP reçoit les données.

    Valeurs valides : binaire ou ASCII

    Valeur par défaut : binaire
    Serveur Spécifiez le nom du serveur ou l’adresse IP du serveur FTP. Note: L’URI d’un port d’envoi ou d’un emplacement de réception ne peut pas dépasser 256 caractères.
    Affilié SSO Spécifiez l'application partenaire Enterprise Single Sign-On.
    Utiliser la liste de noms (NLST) Spécifiez la façon dont l’adaptateur répertorie les fichiers. Pour afficher les noms de fichiers au lieu de la liste de fichiers définie par le système, définissez cette valeur sur Oui.

    Valeur par défaut: Non
    Nom d’utilisateur Spécifiez le nom d'utilisateur pour se connecter au serveur FTP.

    Sondages

    Utiliser cette option Pour ce faire
    Supprimer après le téléchargement Spécifiez si l’adaptateur supprime un fichier du serveur FTP après le téléchargement.

    Valeur par défaut:Oui Remarque :
    Activer la comparaison d’horodatages Spécifiez si l’adaptateur télécharge à nouveau un fichier en fonction de son horodatage modifié. Dans les cas où l’adaptateur n’a pas d’autorisations de suppression sur le serveur FTP, la commande MDTM (Heure de modification) permet à l’adaptateur de savoir si un fichier a été modifié depuis le dernier téléchargement. En fonction de la valeur de cette propriété, le fichier est à nouveau téléchargé.

    Valeur par défaut: Aucune remarque : si le serveur FTP ne prend pas en charge MDTM, définissez la propriété Redownload Interval . Note: Cette propriété s’applique uniquement lorsque Delete After Download a la valeur Non.
    Intervalle Spécifiez le numéro d’intervalle pour interroger cet emplacement. Pour interroger en continu, définissez cette valeur sur zéro (0).

    Valeur par défaut : 60
    Intervalle de retéléchargement Spécifiez l’intervalle après lequel l’adaptateur télécharge à nouveau les fichiers. Cette propriété s’applique uniquement lorsque la fonction Supprimer après téléchargement et Activer la comparaison d’horodatages est définie sur Non.

    Valeur par défaut : -1

    -1 indique que l’adaptateur ne télécharge pas à nouveau les fichiers.

    0 indique que l’adaptateur télécharge le fichier dans chaque cycle d’interrogation.
    Unité Spécifiez le type d’unités pour les propriétés Interval et Redownload Interval .

    Valeurs valides : Secondes, minutes, heures et jours

    Valeur par défaut: Secondes

    SSL

    Utiliser cette option Pour ce faire
    Hachage de certificat client Spécifiez le hachage SHA1 du certificat client qui doit être utilisé dans la négociation SSL (Secure Sockets Layer).

    En fonction de ce hachage, le certificat client est récupéré dans le magasin personnel du compte utilisateur sur lequel s'exécute l'instance d'hôte BizTalk.
    Mode de connexion FTPS Spécifiez le mode de connexion SSL établie au serveur FTPS.

    Valeurs valides : Implicite ou explicite

    Valeur par défaut: Explicite
    Utiliser la protection des données Spécifiez cette valeur comme Oui si l’adaptateur doit utiliser le chiffrement SSL lorsqu’il envoie et reçoit des fichiers de données du serveur FTPS. Spécifiez ce paramètre comme Non pour que l’adaptateur envoie et reçoive des fichiers de données sous forme de texte brut. Note: Cette propriété s’applique uniquement si la propriété Use SSL est définie sur Oui.

    Valeurs valides : Oui ou Non

    Valeur par défaut: Oui
    Utiliser SSL Spécifiez si l’adaptateur FTP doit utiliser SSL pour communiquer avec le serveur FTPS.

    Valeurs valides : Oui ou Non

    Valeur par défaut: Non

    Paramètres de paramétrage

    Utiliser cette option Pour ce faire
    Délai d’expiration des données de réception Spécifiez la durée en millisecondes avant l’abandon de l’appel de réception. Vous utilisez cette propriété pour empêcher un serveur lent de provoquer l’arrêt de réponse de l’emplacement de réception.

    Valeur par défaut : 90000
    Dossier temporaire Spécifiez l’emplacement d’un dossier temporaire. Vous utilisez cet emplacement pour garantir la récupération en cas d'échec de transfert.

  5. Cliquez sur OK pour enregistrer les paramètres.

  6. Dans la boîte de dialogue Propriétés de l’emplacement de réception, entrez les valeurs appropriées pour terminer la configuration de l’emplacement de réception, puis cliquez sur OK pour enregistrer les paramètres. Pour plus d’informations sur la boîte de dialogue Propriétés des emplacements de réception , consultez Comment créer un emplacement de réception.

Remarque

Ne configurez pas plusieurs emplacements de réception FTP pour interroger la même URL FTP. Si plusieurs emplacements de réception FTP interrogent simultanément la même URL, chaque emplacement de réception peut recevoir une copie du fichier, ce qui peut entraîner une duplication des données. Ce comportement se produit parce que le protocole FTP n’a pas de provision pour verrouiller les fichiers lors de leur lecture à partir de l’URL cible.

Pour fournir une haute disponibilité pour l’adaptateur de réception FTP, vous devez configurer l’adaptateur de réception FTP pour qu’il s’exécute dans une instance d’hôte BizTalk en cluster. Consultez considérations pour l’exécution de gestionnaires d’adaptateurs au sein d’un hôte clusterisé.

Configurer le port d’envoi

Vous pouvez définir les propriétés de l’adaptateur de port d’envoi FTP dans la console Administration de BizTalk Server. Si les propriétés ne sont pas définies pour le port d’envoi, les valeurs du gestionnaire d’envoi par défaut dans la console Administration de BizTalk Server sont utilisées.

  1. Dans la console Administration de BizTalk Server, créez un port d’envoi ou double-cliquez sur un port d’envoi existant pour le modifier. Découvrez comment créer un port d’envoi. Configurez toutes les options de port d’envoi et, dans la section Transport de la page Général , spécifiez FTP pour l’option Type .

  2. Dans la page Général , dans la section Transport , cliquez sur le bouton Configurer en regard de Type.

  3. Dans les propriétés de transport FTP, procédez comme suit :

    Pare-feu

    Utiliser cette option Pour ce faire
    Adresse Spécifiez l’adresse du pare-feu, soit un nom DNS, soit une adresse IP.
    Mode Sélectionnez le mode dans lequel l’adaptateur se connecte au serveur FTP.

    Valeurs valides : Passif et actif

    En mode actif, le serveur FTP se connecte à un port ouvert par l’adaptateur FTP. En mode passif, l’adaptateur FTP se connecte à un port ouvert par le serveur FTP. Le mode actif peut ne pas fonctionner si vous utilisez une adresse IP interne et que vous vous connectez à une adresse IP externe. Dans ce cas, vous devez utiliser le mode passif ou le mode actif avec une passerelle de couche application (ALG) avec compatibilité FTP.

    Valeur par défaut: Actif
    Mot de passe Spécifiez le mot de passe du pare-feu.
    Port Spécifiez le port du pare-feu.

    Valeurs valides : 1 à 65535 inclus

    Valeur par défaut : 21
    Type Sélectionnez le type de pare-feu déployé.

    Valeurs valides : Chaussettes 4, Chaussettes 5, Aucun

    Valeur par défaut: Aucun
    Utilisateur Spécifiez le nom d’utilisateur du pare-feu.

    FTP

    Utiliser cette option Pour ce faire
    Compte Optionnel. Spécifiez le nom du compte pour le serveur FTP. Cette option et l'utilisation de cette propriété sont déconseillées.
    Après la mise Spécifiez les commandes FTP à exécuter après le fichier PUT. Séparez les commandes avec un point-virgule (;).
    Allouer l'espace de stockage Spécifiez s’il faut allouer de l’espace de stockage pour les systèmes hôtes hérités. Cette option est fournie pour la compatibilité descendante.

    Valeurs valides : Non et Oui

    Valeur par défaut: Non
    Avant de mettre Spécifiez les commandes FTP à exécuter avant le fichier PUT, par exemple les commandes pour modifier les valeurs par défaut sur le serveur FTP. Séparez les commandes avec un point-virgule (;). Aucune commande open n’est requise. Note: La commande QUIT n’est pas prise en charge avant le fichier PUT.
    Dossier Spécifiez l’emplacement vers lequel déplacer les fichiers sur le serveur FTP.
    Type de serveur FTP Nouveautés à partir de BizTalk Server 2016.

    Utilisez cette propriété pour choisir un serveur FTP qui ne nécessite pas la commande SYST. Les options sont None, AIX, Detect, GXS, MVS, OS400 et Other.

    Si la valeur est None, la commande SYST est utilisée. L’autre est utilisée lorsque le type de système d’exploitation ne correspond à aucune des catégories spécifiées.

    Valeur par défaut: Aucun
    Journal Spécifiez le chemin d’accès complet, y compris le nom de fichier journal vers lequel effectuer la sortie. Utilisez ce fichier pour diagnostiquer les conditions d’erreur lors de l’envoi ou de la réception de fichiers via l’adaptateur FTP.
    Mot de passe Spécifiez le mot de passe pour vous connecter au serveur FTP.
    Port Spécifiez l’adresse de port du serveur FTP.

    Valeur par défaut : 21
    Représentation Sélectionnez la façon dont l’adaptateur FTP envoie les données, en tant que binaire ou en tant qu’ASCII.

    Valeurs valides : binaire ou ASCII

    Valeur par défaut : binaire
    Serveur Spécifiez le nom du serveur ou l’adresse IP du serveur FTP.
    Affilié SSO Spécifiez l'application partenaire Enterprise Single Sign-On.
    Nom de fichier cible Spécifiez un autre nom pour le fichier. La conservation du nom par défaut garantit des noms de messages uniques pour chaque message envoyé.

    Valeur par défaut : %MessageID%.xml
    Nom d’utilisateur Spécifiez le nom d'utilisateur pour se connecter au serveur FTP.

    SSL

    Utiliser cette option Pour ce faire
    Hachage de certificat client Spécifiez le hachage SHA1 du certificat client qui doit être utilisé dans la négociation SSL (Secure Sockets Layer).

    En fonction de ce hachage, le certificat client est récupéré dans le magasin personnel du compte utilisateur sur lequel s'exécute l'instance d'hôte BizTalk.
    Mode de connexion FTPS Spécifiez le mode de connexion SSL établie au serveur FTPS.

    Valeurs valides : Implicite ou explicite

    Valeur par défaut: Explicite
    Utiliser la protection des données Spécifiez cette valeur comme Oui si l’adaptateur doit utiliser le chiffrement SSL lorsqu’il envoie et reçoit des fichiers de données du serveur FTPS. Spécifiez ce paramètre comme Non pour que l’adaptateur envoie et reçoive des fichiers de données sous forme de texte brut. Note: Cette propriété s’applique uniquement si la propriété Use SSL est définie sur Oui.

    Valeurs valides : Oui ou Non

    Valeur par défaut: Oui
    Utiliser SSL Spécifiez si l’adaptateur FTP doit utiliser SSL pour communiquer avec le serveur FTPS.

    Valeurs valides : Oui ou Non

    Valeur par défaut: Non

    Paramètres de paramétrage

    Utiliser cette option Pour ce faire
    Limite de connexion Spécifiez le nombre maximal de connexions FTP simultanées qui peuvent être ouvertes au serveur. La valeur 0 signifie qu’aucune limite n’est définie.

    Valeur par défaut : 0 Remarque : cette propriété remplace l’entrée de Registre utilisée dans les versions antérieures de BizTalk Server pour régir la limite de connexion. BizTalk Server ignore l’entrée de Registre utilisée pour contrôler la limite de connexion.
    Dossier temporaire Spécifiez l’emplacement d’un dossier temporaire sur le serveur FTP. Le fichier est d’abord chargé ici, puis déplacé vers le dossier FTP de destination. En cas d’échec de transfert, l’adaptateur redémarre le chargement du fichier en mode ASCII de transfert et reprend en mode binaire de transfert. Note: Si le transfert de fichiers est atomique entre l’emplacement temporaire et l’emplacement approprié sur le serveur FTP, le chargement du fichier est également atomique.

  4. Cliquez sur OK et OK à nouveau pour enregistrer les paramètres.

Commandes FTP requises par l’adaptateur FTP

L’adaptateur FTP est soumis aux limitations du protocole FTP et exige que certaines commandes FTP soient disponibles sur le serveur FTP source ou de destination.

L’adaptateur FTP fonctionne en tant que client FTP et peut nécessiter que les commandes suivantes soient disponibles sur le serveur FTP pour fonctionner correctement :

Commande Requis pour réception Requis par Send
SYST ✔

Facultatif à partir de BizTalk Server 2016		 ✔

Facultatif à partir de BizTalk Server 2016
BOUTIQUE ✔
RETR ✔
Utilisateur ✔ ✔
PASSER ✔ ✔
CWD ✔ ✔
DÉMISSIONNER ✔ ✔
PORT ✔ ✔
PASV ✔ ✔
ABOR ✔ ✔
TYPE ✔ ✔
RNFR ✔ ✔
RNTO ✔ ✔
DELE ✔ ✔
PWD ✔ ✔
Liste ✔ ✔
NLST ✔ ✔
NOOP ✔ ✔
APPE ✔
ALLO ✔ ✔
MDTM ✔
AUTH TLS ✔ ✔
PBSZ ✔ ✔
PROT ✔ ✔

Pour plus d’informations sur ces commandes FTP, consultez :

Configuration d’un adaptateur FTP pour qu’il fonctionne avec des hôtes hérités

Cette section traite de ce que vous devez savoir pour faciliter la communication entre l’adaptateur FTP et un ordinateur mainframe.

Remarque

Vous ne pouvez pas utiliser la fonction de dossier temporaire lors de l’envoi de fichiers à un hôte MVS ou AS400. L’entrée dans ce champ n’est pas prise en charge et provoque des erreurs.

Important

Les informations suivantes sont fournies sous la forme d’un guide et ne doivent pas être remplacées par des informations figurant dans la documentation AS400 ou IBM.

MVS

Pour envoyer des fichiers à un serveur FTP sur un mainframe, le mainframe doit prendre en charge IBM Generation Data Group (GDG). Dans le champ nom, chaque nom de fichier ajoute un (+1) au nom du fichier de destination (un chemin d’accès complet avec des guillemets autour de celui-ci).

AS400

Il existe trois méthodes de nommage de fichiers et de définition de leurs chemins d’accès lors du transfert de fichiers vers et à partir d’un système AS400 :

  • Champ Nom de fichier : lors de l’envoi d’un fichier à un serveur FTP, entrez le nom du fichier dans le champ Nom de fichier. Le nom de fichier doit être conforme aux conventions d’affectation de noms de fichiers du système AS400, car le fichier sera stocké dans le système de fichiers de bibliothèque.

  • Commande Quote : utilisez la commande Quote pour exécuter un script sur l’ordinateur distant. Entrez la commande Quote dans les champs Before GET, Before PUT, After GET et After PUT sur l’un des points de terminaison. Entrez la commande Quote au format suivant :

    QUOTE RCMD <command to be run on the remote system>.

  • Système de fichiers intégré (IFS) : IFS est une zone sur le système AS400 qui permet le stockage de fichiers basés sur PC et donc les mêmes conventions d’affectation de noms qu’un PC. Pour utiliser l’IFS au lieu du système de fichiers de bibliothèque par défaut, la première commande à entrer est quote site namefmt 1. Cette commande indique au système AS400 d’utiliser la convention d’affectation de noms IFS.

Plus de bonnes choses

Schéma et propriétés de propriété de l’adaptateur FTP

Bonnes pratiques et recommandations pour l’adaptateur FTP

Adaptateur FTP