Adaptateur SFTP

Présentation

Lorsque vous utilisez l'adaptateur SFTP comme source, vous pouvez lire les données d'un fichier et extraire une liste de fichiers présents dans n'importe quel répertoire d'un emplacement de serveur SFTP. Lorsque vous utilisez l'adaptateur SFTP comme cible, vous pouvez envoyer des données vers un fichier spécifié sur le serveur SFTP. Vous pouvez, au choix :

• Créer un nouveau fichier.
• Remplacer un fichier existant.
• Ajouter des données à un fichier existant.

Si vous avez configuré l'adaptateur pour remplacer un fichier ou ajouter des données à un fichier qui n'existe pas, mais si la structure du répertoire dans le chemin d'accès au fichier est valide, le fichier est automatiquement créé. Si la structure de répertoire dans le chemin de fichier spécifié n'existe pas, l'opération d'écriture échoue, sauf si vous avez configuré l'adaptateur pour créer un nouveau répertoire au cas où le chemin d'accès au fichier spécifié n'existerait pas. Dans ce cas, l'adaptateur crée automatiquement les répertoires manquants.

Introduction

SFTP est un protocole de transfert de données de fichiers sécurisé sur des réseaux informatiques. L’adaptateur SFTP obéit à ce protocole et peut être configuré pour agir en tant que client SFTP afin de transférer et d’accéder aux données du fichier depuis et vers des serveurs SFTP.

Alias de commande

Vous pouvez spécifier les commandes d'adaptateur à l'aide d'une chaîne de commande sur la ligne de commande ou en créant un fichier de commandes contenant les commandes d'adaptateur. La syntaxe de la commande est :

-IA[alias]card_num

-OA[alias]card_num

Authentification des connexions

SFTP (Secure File Transfer Protocol) est un protocole de transfert de données de fichiers sécurisé sur des réseaux informatiques. L’adaptateur SFTP obéit à ce protocole et peut être configuré pour agir en tant que client SFTP afin de transférer et d’accéder aux données du fichier depuis et vers des serveurs SFTP.

Vous pouvez sélectionner l'une des deux méthodes d'authentification de votre choix. L'adaptateur essaie d'abord la méthode d'authentification préférée. Si cette tentative échoue, l'adaptateur tente alors de vous authentifier avec l'autre méthode.

Une fois la connexion à un serveur SFTP effectuée, vous pouvez envoyer et recevoir des fichiers depuis et vers le serveur.

Adaptateur SFTP en tant que source

Adaptateur SFTP en tant que cible

Propriétés et commandes de l'adaptateur

Cette section répertorie les propriétés prises en charge par l'adaptateur.

Spécifie le nom d'hôte ou l'adresse IP du serveur SFTP. Cette propriété est obligatoire. La commande d'adaptateur correspondante est -HOSTnom (ou -HOSTNAMEnom).

Spécifie le port sur lequel le serveur SFTP écoute les connexions entrantes. La valeur par défaut est 22. La commande d'adaptateur correspondante est -PORT numéro (ou -PORTNUMBER numéro).

Spécifie la méthode d'authentification à essayer d'utiliser en premier lors de l'établissement d'une connexion. Les valeurs prises en charge sont Mot de passe et Clé publique. La valeur par défaut est Mot de passe. La commande d'adaptateur correspondante est -PA méthode (ou -PREFERREDAUTHENTICATION méthode) où méthode est Mot de passe ou Clé publique.

Indique le nom d'utilisateur pour la connexion. Cette propriété est obligatoire. La commande d'adaptateur correspondante est -USR nom (ou -USERNAME nom).

Spécifie la valeur de mot de passe à utiliser lors de l'authentification basée sur un mot de passe. La commande d'adaptateur correspondante est -PWD valeur (ou -PASSWORD valeur).

Spécifie l'emplacement du fichier d'hôtes connus. La valeur est facultative et, lorsqu'elle est spécifiée, entraîne l'application de la vérification stricte du nom d'hôte par rapport au fichier spécifié lors de l'établissement des connexions. Si elle n'est pas spécifiée, la vérification du nom d'hôte n'est pas stricte. La commande d'adaptateur correspondante est -KHFP chemin (ou -KNOWNHOSTSFILEPATH chemin).

Spécifie le nom de la paire de clés à utiliser lors de l'authentification basée sur une paire de clés. La valeur est facultative et, lorsqu'elle n'est pas spécifiée, le nom identifiant la paire de clés est dérivé du nom du fichier de clé privée. La commande d'adaptateur correspondante est -KPN nom (ou -KEYPAIRNAME nom).

Spécifie la phrase de passe permet d'accéder aux données de clé lors de l'authentification basée sur une paire de clés. La valeur est facultative et, lorsqu'elle n'est pas spécifiée, on suppose que la clé n'est pas protégée par une phrase de passe. La commande d'adaptateur correspondante est -PSP valeur (ou -PASSPHRASE valeur).

Spécifie la durée d'attente, en secondes, pour que le serveur réponde lors de l'établissement d'une connexion, avant de considérer la tentative de connexion comme ayant échoué. La valeur par défaut est 30. La valeur 0 indique qu'aucun délai d'attente n'est défini. La commande d'adaptateur correspondante est -CT durée (ou -CONNECTIONTIMEOUT durée).

Spécifie la durée d'attente, en secondes, entre deux nouvelles tentatives de connexion successives. La valeur par défaut est 60. Ce paramètre n'est applicable que lorsque le paramètre Nombre de nouvelles tentatives de connexion est défini sur une valeur supérieure à 0.

La commande d'adaptateur correspondante est -RCI durée (ou -RETRYCONNECTIONINTERVAL durée).

Spécifie le chemin du fichier ou du répertoire sur le serveur SFTP. Le caractère barre oblique (/) est utilisé comme séparateur de fichier. Si la valeur de chemin indiquée commence par une barre oblique, elle est traitée comme un chemin d'accès absolu ; Sinon, elle est traitée comme un chemin relatif au répertoire par défaut actuel pour la connexion. La commande d'adaptateur correspondante est -P chemin ou (-PATH chemin).

Spécifie le paramètre qui, lorsqu'il est activé, entraîne la création automatique de tous les répertoires manquants dans le chemin d'accès au répertoire spécifié. Lorsqu'il n'est pas activé, l'adaptateur signale une erreur si la structure de répertoire spécifiée n'existe pas sur le serveur SFTP. Le paramètre est applicable uniquement lorsque l'adaptateur est utilisé en tant que cible. La commande d'adaptateur correspondante est -CD (ou -CREATEDIRECTORY).

Cette propriété spécifie le mode dans lequel l'adaptateur doit être utilisé en tant que source. Le mode Données de fichier permet de lire le contenu du fichier spécifié dans le paramètre Chemin. Le mode Liste de fichiers permet d'extraire la liste des chemins absolus des fichiers situés dans le répertoire spécifié dans le paramètre Chemin. La valeur par défaut est Données de fichier. La commande d'adaptateur correspondante est -RM mode (ou -READMODE mode), où mode est file_data ou file_list.

Spécifie le mode dans lequel l'adaptateur doit être utilisé en tant que source. Le mode Données de fichier permet de lire le contenu du fichier spécifié dans le paramètre Chemin. Le mode Liste de fichiers permet d'extraire la liste des chemins absolus des fichiers situés dans le répertoire spécifié dans le paramètre Chemin. La valeur par défaut est Données de fichier. La commande d'adaptateur correspondante est -WM mode (ou -WRITEMODE mode), où mode est create, overwrite ou append.

Cette propriété spécifie le niveau de journalisation à utiliser pour le fichier journal (fichier de trace) produit par l'adaptateur. La valeur par défaut est Désactivé. La valeur Informatif permet de consigner les messages d'information et d'erreur, la valeur Erreurs uniquement permet de consigner uniquement les messages d'erreur et la valeur Prolixe permet de consigner les messages de débogage et de niveau de trace en plus des messages d'information et d'erreur.

La commande d'adaptateur correspondante est :

-T [E|V] [+] [file_path]

-T -> Consignation des messages d'information de l'adaptateur.

-TE -> Consignation des erreurs de l'adaptateur uniquement.

-TV -> Utilisation de la consignation prolixe (débogage). Le fichier journal consigne toute l'activité lorsque l'adaptateur génère ou consomme des messages.

+ -> Ajout des informations de trace à un fichier existant. Omettez cet argument pour créer un nouveau fichier journal.

file_path -> Le chemin d'accès complet au journal de trace de l'adaptateur. Si vous omettez ce mot clé, l'adaptateur crée le fichier journal m4sftp.mtr dans le répertoire de mappe.

Indicateur spécifiant l'action à effectuer si le fichier journal spécifié existe déjà. Lorsque la valeur est true, les messages du journal sont ajoutés au fichier. Lorsque la valeur est false, le fichier est tronqué et les messages sont écrits dans le fichier vide. La valeur par défaut est true.

Indique l'emplacement du fichier journal dans lequel les messages doivent être consignés. S'il n'est pas spécifié, le système utilise le nom de fichier journal par défaut m4sftp.mtr et stocke le fichier dans le répertoire où se trouve la mappe compilée exécutée.

Exemples