protocole SFTP

Actions de flux de travaux

• Télécharger le fichier : Télécharge un fichier spécifique sur le serveur SFTP.

• Télécharger le fichier : Télécharge un fichier spécifique à partir du serveur SFTP.

• Append file (Ajouter un fichier) : Ajoute un fichier local spécifique à un fichier existant sur le serveur SFTP.

• Supprimer le répertoire : Supprime le répertoire spécifié du serveur SFTP.

• Créer un répertoire : Crée un répertoire à l'emplacement spécifié sur le serveur SFTP.

• Obtenir la liste des fichiers et des dossiers : Récupère la liste des fichiers et des dossiers d'un répertoire spécifié sur le serveur SFTP.

• Supprimer le fichier : Supprime un fichier spécifique du serveur SFTP.

• Créer un lien symbolique : Crée un lien symbolique vers un fichier spécifique.

• Renommer un fichier ou un dossier : Renomme un fichier ou un dossier spécifique du serveur FTP.

• Modifier la propriété : Modifie la propriété d'un fichier ou d'un dossier spécifique.

• Modifier l'autorisation d'un fichier ou d'un dossier : Modifie l'autorisation d'un fichier ou d'un dossier spécifique.

• Modifier la propriété du groupe : Modifie les autorisations du groupe pour un fichier ou un dossier spécifique.

Service d'écoulement Actions

• cd : Modifier le répertoire de travail sur le serveur SFTP distant.

• chgrp : Modifier la propriété de groupe d'un ou de plusieurs fichiers distants.

• chmod : Modifier les droits d'un ou de plusieurs fichiers distants.

• chown : Modifier l'utilisateur propriétaire d'un ou plusieurs fichiers distants.

• get : Récupérer un fichier spécifique à partir d'un serveur SFTP distant.

• ls : Liste les fichiers d'un répertoire distant spécifié, avec des détails tels que les autorisations et la propriété. Si aucun répertoire n'est spécifié, il répertorie les fichiers du répertoire distant actuel.

• mkdir : Créer un nouveau répertoire distant.

• put : Transférer un fichier vers un serveur SFTP distant.

• pwd : Affiche le répertoire de travail distant dans le serveur SFTP.

• renommer : Renommer un fichier ou un répertoire sur un serveur SFTP distant.

• rm : Supprime un ou plusieurs fichiers distants sur le serveur SFTP.

• rmdir : Supprime un ou plusieurs répertoires distants sur le serveur SFTP.

• lien symbolique : Créer un lien symbolique entre l'ancien et le nouveau chemin d'accès d'un fichier spécifique.

Questions fréquentes

Comment créer un compte pour le connecteur SFTP?

Pour ajouter un compte pour SFTP dans webMethods Integration :

• Faites glisser n'importe quelle action SFTP sur le canevas et double-cliquez sur l'action.
• Cliquez sur le "+" qui se trouve à côté du champ Connecter au serveur SFTP. La fenêtre Ajouter un compte s'affiche avec les champs de configuration du compte :
  • Nom du compte : Nom du compte SFTP.
  • Hôte : L'hôte ou l'adresse IP du serveur SFTP.
  • Port : Le numéro de port avec lequel vous souhaitez vous connecter.

  • Créer une connexion à l'aide de : Le type de connexion que vous souhaitez utiliser pour établir une connexion.

  Si vous sélectionnez Login Credential comme type de connexion, les champs qui s'affichent sont énumérés ici :

  • Nom d'utilisateur : Indiquez le nom d'utilisateur de votre serveur SFTP.
  • Mot de passe : Saisissez le mot de passe associé au nom d'utilisateur du serveur SFTP spécifié.
  • Algorithm Keys (clés d'algorithme ) : Spécifiez les clés pour remplacer explicitement les clés d'algorithme de couche de transport par défaut utilisées pour la connexion.
  • Server Host Keys (Clés d'hôte du serveur ) : Indiquez les clés d'hôte pour remplacer explicitement les clés d'hôte du serveur de couche de transport par défaut utilisées pour la connexion.
  • Chiffres : Spécifiez les algorithmes de chiffrement pour remplacer explicitement les algorithmes de chiffrement de la couche de transport par défaut utilisés pour la connexion.
  • Hmacs : Spécifiez les algorithmes (H)MAC pour remplacer explicitement les algorithmes (H)MAC de la couche de transport par défaut utilisés pour la connexion.
  • Compress : Spécifiez les algorithmes de compression pour remplacer explicitement la compression par défaut de la couche transport utilisée pour la connexion.
  • Ready Timeout (Délai d'attente ) : Spécifiez le temps (en millisecondes) nécessaire à l'établissement d'une connexion SSH sécurisée. La valeur par défaut est de 20000 millisecondes (20 secondes).
  • Retries (Tentatives ) : Indiquez le nombre maximal de tentatives d'établissement d'une connexion SSH sécurisée. La valeur par défaut de ce champ est 2.
  • Retry Factor : Spécifiez le facteur de temps pour calculer le délai entre les tentatives. La valeur par défaut de ce champ est 2.
  • Retry Minimum Timeout (Délai minimum de réessai ) : Indiquez le délai (en millisecondes) pendant lequel le serveur doit attendre entre les tentatives de réessai. La valeur par défaut de ce champ est 2000 (2 secondes).
  • Intervalle de maintien en vie : Indiquez la fréquence (en millisecondes) d'envoi au serveur de paquets de maintien en vie au niveau SSH. Si vous souhaitez désactiver cette option et maintenir la session en vie indéfiniment, indiquez "0" dans ce champ. La valeur par défaut de ce champ est 0. Par exemple, si vous définissez la valeur 3000 pour ce champ, cela signifie que le serveur reçoit des paquets "keep-alive" toutes les 3 secondes.
  • Keep Alive Count Max : Indique combien de paquets keepalive consécutifs et sans réponse au niveau SSH peuvent être envoyés au serveur avant d'arrêter la session de connexion. La valeur par défaut de ce champ est 3. Toutefois, ce champ peut être utilisé avec le champ Intervalle de maintien en vie. Par exemple, si l' intervalle de maintien en vie est fixé à 2000 (2 secondes) et le nombre maximal de maintien en vie à 3, le serveur reçoit des paquets de maintien en vie toutes les 2 secondes, jusqu'à 3 fois, pour maintenir la connexion. Si les paquets restent sans réponse trois fois de suite, la session de connexion est interrompue.

  Si vous sélectionnez Clé SSH comme type de connexion, les champs qui apparaissent sont listés ici :

  • Nom d'utilisateur : Indiquez le nom d'utilisateur de votre serveur SFTP.
  • Clé SSH : Indiquez le chemin d'accès à la clé SSH associée au nom d'utilisateur spécifié.
  • Phrase de passe : Indiquez la phrase de passe de la clé SSH associée au nom d'utilisateur spécifié.
  • Algorithm Keys (clés d'algorithme ) : Spécifiez les clés pour remplacer explicitement les clés d'algorithme de couche de transport par défaut utilisées pour la connexion.
  • Server Host Keys (Clés d'hôte du serveur ) : Indiquez les clés d'hôte pour remplacer explicitement les clés d'hôte du serveur de couche de transport par défaut utilisées pour la connexion.
  • Chiffres : Spécifiez les algorithmes de chiffrement pour remplacer explicitement les algorithmes de chiffrement de la couche de transport par défaut utilisés pour la connexion.
  • Hmacs : Spécifiez les algorithmes (H)MAC pour remplacer explicitement les algorithmes (H)MAC de la couche de transport par défaut utilisés pour la connexion.
  • Compress : Spécifiez les algorithmes de compression pour remplacer explicitement la compression par défaut de la couche transport utilisée pour la connexion.

  • Ready Timeout (Délai d'attente ) : Spécifiez le temps (en millisecondes) nécessaire à l'établissement d'une connexion SSH sécurisée. La valeur par défaut est de 20000 millisecondes (20 secondes).

  • Retries (Tentatives ) : Indiquez le nombre maximal de tentatives d'établissement d'une connexion SSH sécurisée. La valeur par défaut de ce champ est 2.
  • Retry Factor : Spécifiez le facteur de temps pour calculer le délai entre les tentatives. La valeur par défaut de ce champ est 2.
  • Retry Minimum Timeout (Délai minimum de réessai ) : Indiquez le délai (en millisecondes) pendant lequel le serveur doit attendre entre les tentatives de réessai. La valeur par défaut de ce champ est 2000 (2 secondes).
  • Intervalle de maintien en vie : Spécifiez la fréquence (en millisecondes) d'envoi de paquets de maintien de niveau SSH au serveur SSH. Si vous souhaitez désactiver cette option et maintenir la session en vie indéfiniment, indiquez "0" dans ce champ. La valeur par défaut de ce champ est 0. Par exemple, si vous définissez la valeur 3000 pour ce champ, cela signifie que le serveur reçoit des paquets "keep-alive" toutes les 3 secondes.
  • Keep Alive Count Max : Indique le nombre de paquets keepalive consécutifs, sans réponse, qui peuvent être envoyés au serveur avant la déconnexion. La valeur par défaut de ce champ est 3. Toutefois, ce champ peut être utilisé avec le champ Intervalle de maintien en vie. Par exemple, si le champ Intervalle de maintien en vie est fixé à 2000 (2 secondes) et que le champ Compte de maintien en vie maximum est fixé à 3, cela signifie que le serveur reçoit des paquets de maintien en vie toutes les 2 secondes, pour un maximum de 3 fois, afin de maintenir la connexion en vie. Si les paquets restent sans réponse trois fois de suite, la connexion est interrompue automatiquement.

• Cliquez ensuite sur Enregistrer. Le compte pour le connecteur SFTP est créé.

Pourquoi l'exécution du service Flow échoue-t-elle avec une erreur pour le compte SFTP : La clé d'hôte a été modifiée?

Si la clé d'hôte est modifiée après la création du compte SFTP, mettez manuellement à jour le compte pour obtenir la clé d'hôte la plus récente afin d'éviter les échecs de transaction.

Quelles sont les différentes méthodes de téléchargement disponibles sous l'action Download File ( v6 ) du connecteur SFTP pour les workflows?

L'action Télécharger un fichier ( v6 ) du connecteur SFTP permet de télécharger un fichier spécifique à partir d'un serveur SFTP distant. Les méthodes disponibles dans le cadre de cette action sont énumérées ici :

• FastGet

  La méthode FastGet est utilisée pour transférer des fichiers volumineux à partir d'un serveur distant. Il se concentre sur le transfert de morceaux d'un fichier par lots plutôt que de l'ensemble du fichier afin d'obtenir un débit plus rapide.

  Lorsque vous sélectionnez FastGet comme méthode de téléchargement, les champs suivants apparaissent à l'écran :

  • ChunkSize : Spécifie la taille du lot (en octets) pour le transfert de données entre le connecteur SFTP du flux de travail et le serveur SFTP distant. La valeur par défaut est de 4096 octets.
  • Concurrence : Ce champ indique le nombre de transferts de lots autorisés simultanément. La valeur par défaut de ce champ est 1.
  Note : Si les valeurs configurées pour les champs Chunk Size, Concurrency et Workflow Runtime sont insuffisantes pour terminer le téléchargement du fichier, le workflow peut rencontrer une erreur Timeout. Si un fichier fait 800 Mo et que les paramètres Chunk Size, Concurrency et Workflow Runtime sont respectivement fixés à 4096, 1 et 3 minutes, le téléchargement risque d'expirer avant d'être terminé.

• Obtenir

  La méthode Get permet d'accéder au répertoire concerné et de transférer le fichier spécifié du serveur distant vers le système local à l'aide du protocole SFTP.

Renseignements supplémentaires