Partager via

Configuration de l'adaptateur FTP

  • Article

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 en mode ASCII.

Consultez Meilleures pratiques et recommandations pour 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 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 d’administration BizTalk Server sont utilisées.

Notes

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

  1. Dans la console Administration BizTalk Server, développez BizTalk Server Administration, BizTalk Group, Applications, puis 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 Propriétés de transport FTP, procédez comme suit :

    Batch

    Propriété Pour
    Nombre maximal de fichiers Indiquer le nombre maximal de fichiers par lot BizTalk Server.

    La valeur zéro (0) indique qu'aucune limite n'est définie.

    Valeur par défaut : 0
    Taille maximale Indiquer le nombre maximal d'octets par lot BizTalk Server.

    La valeur zéro (0) indique qu'aucune limite n'est définie.

    Valeur par défaut : 0

    Pare-feu

    Propriété Pour
    Adresse Indiquer l'adresse du pare-feu, à savoir un nom DNS ou une adresse IP.
    Mode Indiquez le mode utilisé par l'adaptateur pour se connecter 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 actif avec une passerelle de couche application (ALG) avec prise en charge FTP.

    Valeur par défaut : Active
    Mot de passe Indiquer le mot de passe du pare-feu.
    Port Indiquer le port du pare-feu.

    Valeurs valides : 1 à 65535 inclus

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

    Valeurs valides : Aucun, Chaussettes 4 et Chaussettes 5

    Valeur par défaut : Aucun
    Utilisateur Indiquer le nom d'utilisateur associé au pare-feu.

    FTP

    Propriété Pour
    Compte Indiquer 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 l’obtention Spécifiez les commandes FTP à exécuter après le fichier GET. Séparez les commandes par un point-virgule (;).
    Avant obtention Spécifiez les commandes FTP à exécuter avant le fichier GET. Séparez les commandes par un point-virgule (;). Note: La commande QUIT n’est pas prise en charge avant le fichier GET.
    Seuil d'erreur Indiquer le nombre d'erreurs que le serveur BizTalk Server peut rencontrer avant que l'emplacement ne soit désactivé.

    Valeur par défaut : 10
    Masque de fichier Indiquer le filtre de masque de fichier à utiliser pour la transmission des fichiers.
    Folder Indiquer l'emplacement d'interrogation sur le serveur FTP.
    Type de serveur FTP Nouveauté à compter 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. Un autre est utilisé lorsque le type de système d’exploitation n’entre dans 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 du 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 Indiquer la taille maximale de téléchargement des fichiers (en Mo).

    Zéro (0) indique que la taille des fichiers n'est pas limitée.

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

    Valeur par défaut : 21
    Représentation Permet de sélectionner la méthode de réception des données via FTP.

    Valeurs valides : binaire ou ASCII

    Valeur par défaut : binary
    Serveur Indiquer le nom de 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.
    Application associée SSO Indiquer l'application associée à authentification unique de l'entreprise.
    Utiliser la liste de noms (NLST) Indiquer la méthode utilisée par l'adaptateur pour répertorier les fichiers. Pour afficher les noms de fichier 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 Indiquer le nom d'utilisateur pour la connexion au serveur FTP.

    Sondages

    Propriété Pour
    Supprimer après téléchargement Indiquer si l'adaptateur supprime un fichier du serveur FTP après l'avoir téléchargé.

    Valeur par défaut :Oui Remarque :
    Activer la comparaison de cachets de date Indiquer si l'adaptateur télécharge de nouveau un fichier selon le cachet de date modifié. Lorsque l'adaptateur ne possède 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. Selon la valeur de cette propriété, le fichier est de 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 Supprimer après téléchargement est défini sur Non.
    Intervalle Indiquer la fréquence d'interrogation de cet emplacement. Pour effectuer une interrogation continue, 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 valeur Supprimer après téléchargement et Activer la comparaison d’horodatage est définie sur Non.

    Valeur par défaut : -1

    -1 indique que l'adaptateur téléchargera de nouveau les fichiers.

    0 indique que l'adaptateur téléchargera le fichier à 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

    Propriété Pour
    Code de hachage du certificat client Spécifier le code de hachage SHA1 du certificat client qui doit être utilisé dans la négociation SSL.

    Selon ce hachage, le certificat client est récupéré dans le magasin personnel du compte d'utilisateur sous lequel l'instance de l'hôte de BizTalk est exécutée.
    Mode de connexion FTPS Spécifier le mode de connexion SSL au serveur FTPS.

    Valeurs valides : Implicite ou explicite

    Valeur par défaut : Explicite
    utiliser la protection des données Définir ce paramètre sur Oui si l'adaptateur doit utiliser le chiffrement SSL lors de l'envoi et de la réception des fichiers de données à partir du serveur FTPS. Définissez ce paramètre sur Non pour que l'adaptateur envoie et réceptionne les fichiers de données en texte brut. Note: Cette propriété s’applique uniquement si la propriété Utiliser SSL a la valeur Oui.

    Valeurs valides : Oui ou Non

    Valeur par défaut : Oui
    Utiliser SSL Indiquer si l'adaptateur FTP doit utiliser une connexion SSL pour communiquer avec le serveur FTPS.

    Valeurs valides : Oui ou Non

    Valeur par défaut : Non

    Paramètres de paramétrage

    Propriété Pour
    Délai d'expiration de réception des données Indiquer le délai (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 la réponse de l’emplacement de réception.

    Valeur par défaut : 90000
    Dossier temporaire Indiquer l'emplacement du dossier temporaire. Cet emplacement permet la récupération après un é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 de l'emplacement de réception , consultez la rubrique Création d'un emplacement de réception.

Notes

Ne configurez pas plusieurs emplacements de réception FTP pour interroger la même URL FTP. Si plusieurs emplacements de réception FTP interrogent la même URL simultanément, chaque emplacement de réception peut recevoir une copie du fichier, ce qui peut entraîner des données dupliquées. Ce comportement survient car le protocole FTP n'a pas été configuré pour le verrouillage des fichiers lors de leur lecture à partir de l'URL cible.

Pour assurer la haute disponibilité de l’adaptateur de réception FTP, vous devez configurer l’adaptateur de réception FTP pour qu’il s’exécute dans un instance hôte BizTalk en cluster. Consultez Considérations relatives à l’exécution de gestionnaires d’adaptateurs dans un hôte cluster.

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 BizTalk Server. Si les propriétés ne sont pas définies pour le port d’envoi, les valeurs par défaut du gestionnaire d’envoi dans la console d’administration BizTalk Server sont utilisées.

  1. Dans la console d’administration BizTalk Server, créez un port d’envoi ou double-cliquez sur un port d’envoi existant pour le modifier. Consultez 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 Propriétés de transport FTP, procédez comme suit :

    Pare-feu

    Propriété Pour
    Adresse Indiquer l'adresse du pare-feu, à savoir un nom DNS ou une adresse IP.
    Mode Spécifier le mode utilisé par l'adaptateur pour se connecter 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 prise en charge ftp.

    Valeur par défaut : Active
    Mot de passe Indiquer le mot de passe du pare-feu.
    Port Indiquer le port du pare-feu.

    Valeurs valides : 1 à 65535 inclusivement

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

    Valeurs valides : Chaussettes 4, Chaussettes 5, Aucun

    Valeur par défaut : Aucun
    Utilisateur Indiquer le nom d'utilisateur associé au pare-feu.

    FTP

    Propriété Pour
    Compte facultatif. Indiquer le nom du compte pour le serveur FTP. L'option est supprimée et l'utilisation de cette propriété est déconseillée.
    Après placement Indiquer les commandes FTP à exécuter après le fichier PUT. Séparez les commandes par un point-virgule (;).
    Allocation de stockage Indiquer si de l'espace de stockage doit être alloué pour les systèmes hôtes existants. Cette option est fournie à des fins de compatibilité descendante.

    Valeurs valides : Non et Oui

    Valeur par défaut : Non
    Avant placement Indiquer les commandes FTP à exécuter avant le placement du fichier, telles que les commandes permettant de modifier les valeurs par défaut sur le serveur FTP. Séparez les commandes par un point-virgule (;). Aucune commande Ouvrir n'est requise. Note: La commande QUIT n’est pas prise en charge avant le fichier PUT.
    Folder Indiquer l'emplacement vers lequel déplacer les fichiers sur le serveur FTP.
    Type de serveur FTP Nouveauté à compter 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. Un autre est utilisé lorsque le type de système d’exploitation n’entre dans 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 du fichier journal vers lequel effectuer la sortie. Ce fichier permet de diagnostiquer les conditions d'erreur lors de l'envoi ou de la réception de fichiers via l'adaptateur FTP.
    Mot de passe Spécifier le mot de passe de connexion au serveur FTP.
    Port Spécifier l'adresse du port du serveur FTP.

    Valeur par défaut : 21
    Représentation Sélectionner la méthode utilisée par l'adaptateur FTP pour l'envoi de données (au format binaire ou ASCII).

    Valeurs valides : binaire ou ASCII

    Valeur par défaut : binaire
    Serveur Indiquer le nom de serveur ou l'adresse IP du serveur FTP.
    Application associée SSO Indiquer l'application associée à authentification unique de l'entreprise.
    Nom de fichier cible Indiquer un autre nom pour le fichier. Conserver le nom par défaut garantit l'unicité des noms de message pour chaque message envoyé.

    Valeur par défaut : %MessageID%.xml
    Nom d’utilisateur Indiquer le nom d'utilisateur pour la connexion au serveur FTP.

    SSL

    Propriété Pour
    Code de hachage du certificat client Spécifier le code de hachage SHA1 du certificat client qui doit être utilisé dans la négociation SSL.

    Selon ce hachage, le certificat client est récupéré dans le magasin personnel du compte d'utilisateur sous lequel l'instance de l'hôte de BizTalk est exécutée.
    Mode de connexion FTPS Spécifier le mode de connexion SSL au serveur FTPS.

    Valeurs valides : Implicite ou explicite

    Valeur par défaut : Explicite
    utiliser la protection des données Définir ce paramètre sur Oui si l'adaptateur doit utiliser le chiffrement SSL lors de l'envoi et de la réception des fichiers de données à partir du serveur FTPS. Définissez ce paramètre sur Non pour que l'adaptateur envoie et réceptionne les fichiers de données en texte brut. Note: Cette propriété s’applique uniquement si la propriété Utiliser SSL est définie sur Oui.

    Valeurs valides : Oui ou Non

    Valeur par défaut : Oui
    Utiliser SSL Indiquer si l'adaptateur FTP doit utiliser une connexion SSL pour communiquer avec le serveur FTPS.

    Valeurs valides : Oui ou Non

    Valeur par défaut : Non

    Paramètres de paramétrage

    Propriété Pour
    Connection Limit (Limite de connexion) Spécifier un nombre maximal de connexions FTP simultanées pouvant être établies vers le serveur. La valeur 0 indique une absence de limite.

    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 Indiquer l'emplacement d'un dossier temporaire sur le serveur FTP. Ce fichier est d'abord téléchargé ici, puis déplacé vers le dossier FTP de destination. En cas d'échec du transfert, l'adaptateur redémarre le téléchargement du fichier en mode de transfert ASCII et reprend le mode binaire pour le 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 , puis sur OK à nouveau pour enregistrer les paramètres.

Commandes FTP requises par l’adaptateur FTP

L'adaptateur FTP est soumis aux limitations du protocole FTP. Il requiert que certaines commandes FTP soient disponibles sur le serveur FTP source et de destination.

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

Commande Requis par réception Requis par Send
SYST ✔

Facultatif à partir de BizTalk Server 2016		 ✔

Facultatif à partir de BizTalk Server 2016
STOCKAGE ✔
RETR ✔
Utilisateur ✔ ✔
PASS ✔ ✔
CWD ✔ ✔
QUIT ✔ ✔
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.

Notes

Vous ne pouvez pas utiliser la fonction de dossier temporaire dans le cadre de l'envoi de fichiers à un hôte MVS ou AS400. La saisie dans ce champ n'est pas prise en charge et génère des erreurs.

Important

Les informations suivantes sont des indications et ne doivent pas remplacer celles disponibles dans la documentation AS400 ou IBM.

MVS

Pour envoyer des fichiers à un serveur FTP sur un macroordinateur, ce dernier doit prendre en charge le groupe GDG (Generation Data Group) IBM. Dans le champ de nom, chaque nom de fichier ajoute un (+1) au nom du fichier de destination (chemin d'accès complet entouré de guillemets).

AS400

Il existe trois méthodes pour nommer les fichiers et définir leurs chemins d'accès dans le cadre du transfert de fichiers via un système AS400 :

  • Champ Nom de fichier : lors de l’envoi d’un fichier à un serveur FTP, entrez le nom de fichier dans le champ Nom de fichier . Celui-ci doit être conforme aux conventions d'affectation de noms de fichier du système AS400 car il sera stocké dans le système de fichiers 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. en utilisant le 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, par conséquent, 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. Celle-ci indique au système AS400 d'utiliser la convention d'affectation de noms du système IFS.

Autres informations utiles

Propriétés et schéma de propriété de l’adaptateur FTP

Meilleures pratiques et recommandations pour l’adaptateur FTP

adaptateur FTP