Superviser, créer et gérer des fichiers SFTP à l’aide d’Azure Logic AppsMonitor, create, and manage SFTP files by using Azure Logic Apps

Pour automatiser les tâches qui surveillent, créent, envoient et reçoivent des fichiers sur un serveur Secure File Transfer Protocol (SFTP), vous pouvez générer et automatiser les workflows d’intégration à l’aide d’Azure Logic Apps et du connecteur SFTP.To automate tasks that monitor, create, send, and receive files on a Secure File Transfer Protocol (SFTP) server, you can build and automate integration workflows by using Azure Logic Apps and the SFTP connector. SFTP est un protocole réseau qui fournit un accès aux fichiers, le transfert de fichiers et la gestion des fichiers sur n’importe quel flux de données fiable.SFTP is a network protocol that provides file access, file transfer, and file management over any reliable data stream. Voici quelques exemples de tâches que vous pouvez automatiser :Here are some example tasks you can automate:

  • Superviser à quel moment des fichiers sont ajoutés ou changés.Monitor when files are added or changed.
  • Obtenir, créer, copier, mettre à jour, lister et supprimer des fichiers.Get, create, copy, update, list, and delete files.
  • Obtenir les métadonnées et le contenu des fichiers.Get file content and metadata.
  • Extraire des archives dans des dossiers.Extract archives to folders.

Vous pouvez utiliser des déclencheurs qui surveillent les événements sur votre serveur SFTP et mettent la sortie à la disposition d’autres actions.You can use triggers that monitor events on your SFTP server and make output available to other actions. Vous pouvez utiliser des actions qui effectuent diverses tâches sur votre serveur SFTP.You can use actions that perform various tasks on your SFTP server. Vous pouvez également faire en sorte que d’autres actions de votre application logique utilisent la sortie d’actions SFTP.You can also have other actions in your logic app use the output from SFTP actions. Par exemple, si vous récupérez régulièrement des fichiers de votre serveur SFTP, vous pouvez envoyer des alertes par e-mail au sujet de ces fichiers et de leur contenu en utilisant le connecteur Office 365 Outlook ou le connecteur Outlook.com.For example, if you regularly retrieve files from your SFTP server, you can send email alerts about those files and their content by using the Office 365 Outlook connector or Outlook.com connector. Si vous débutez avec les applications logiques, consultez Qu’est-ce qu’Azure Logic Apps ?If you're new to logic apps, review What is Azure Logic Apps?

limitesLimits

Le connecteur SFTP gère uniquement les fichiers dont la taille est inférieure ou égale à 50 Mo et ne prend pas en charge la segmentation des messages.The SFTP connector handles only files that are 50 MB or smaller and doesn't support message chunking. Pour les fichiers plus grands, utilisez le connecteur SFTP-SSH.For larger files, use the SFTP-SSH connector. Pour connaître les différences entre le connecteur SFTP et le connecteur SFTP-SSH, consultez Comparer SFTP/SSH par rapport à SFTP dans l’article SFTP-SSH.For differences between the SFTP connector and the SFTP-SSH connector, review Compare SFTP-SSH versus SFTP in the SFTP-SSH article.

PrérequisPrerequisites

  • Un abonnement Azure.An Azure subscription. Si vous n’avez pas d’abonnement Azure, inscrivez-vous pour bénéficier d’un compte Azure gratuit.If you don't have an Azure subscription, sign up for a free Azure account.

  • Vos informations d’identification de compte et adresse du serveur SFTP, qui permettent à votre application logique d’accéder à votre compte SFTP.Your SFTP server address and account credentials, which let your logic app access your SFTP account. Pour utiliser le protocole SSH (Secure Shell), vous devez également accéder à une clé privée SSH et au mot clé privé SSH.To use the Secure Shell (SSH) protocol, you also need access to an SSH private key and the SSH private key password.

    Notes

    Le connecteur SFTP prend en charge ces formats de clé privée : OpenSSH, ssh.com et PuTTYThe SFTP connector supports these private key formats: OpenSSH, ssh.com, and PuTTY

    Lorsque vous créez votre application logique, après avoir ajouté le déclencheur SFTP ou une action , vous devrez fournir les informations de connexion pour votre serveur SFTP.When you're creating your logic app, after you add the SFTP trigger or action you want, you'll need to provide connection information for your SFTP server. Si vous utilisez une clé privée SSH, assurez-vous de copier la clé à partir de votre fichier de clé privée SSH, puis collez cette clé dans les détails de connexion. N’entrez pas manuellement ou ne modifiez pas la clé car cela peut entraîner l’échec de la connexion.If you're using an SSH private key, make sure you copy the key from your SSH private key file, and paste that key into the connection details, Don't manually enter or edit the key, which might cause the connection to fail. Pour plus d’informations, consultez les étapes détaillées plus loin dans cet article.For more information, see the later steps in this article.

  • Des connaissances de base en création d’applications logiquesBasic knowledge about how to create logic apps

  • L’application logique à partir de laquelle vous souhaitez accéder à votre compte SFTP.The logic app where you want to access your SFTP account. Pour démarrer avec un déclencheur SFTP, créez une application logique vide.To start with an SFTP trigger, create a blank logic app. Pour utiliser une action SFTP, démarrez votre application logique avec un autre déclencheur, par exemple, le déclencheur Périodicité.To use an SFTP action, start your logic app with another trigger, for example, the Recurrence trigger.

Fonctionnement des déclencheurs SFTPHow SFTP triggers work

Les déclencheurs SFTP fonctionnent en interrogeant le système de fichiers SFTP et en recherchant tout fichier changé depuis la dernière interrogation.SFTP triggers work by polling the SFTP file system and looking for any file that was changed since the last poll. Certains outils permettent de conserver l’horodatage lorsque les fichiers sont modifiés.Some tools let you preserve the timestamp when the files change. Dans ce cas, vous devez désactiver cette fonctionnalité pour permettre l’exécution du déclencheur.In these cases, you have to disable this feature so your trigger can work. Voici quelques paramètres communs :Here are some common settings:

Client SFTPSFTP client ActionAction
WinscpWinscp Accédez à Options > Préférences > Transférer > Modifier > Conserver l’horodatage > DésactiverGo to Options > Preferences > Transfer > Edit > Preserve timestamp > Disable
FileZillaFileZilla Accédez à Transférer > Conserver les horodatages des fichiers transférés > DésactiverGo to Transfer > Preserve timestamps of transferred files > Disable

Quand un déclencheur détecte un nouveau fichier, il vérifie que le nouveau fichier est complet et non partiellement écrit.When a trigger finds a new file, the trigger checks that the new file is complete, and not partially written. Par exemple, un fichier peut être en cours de modification lorsque le déclencheur vérifie le serveur de fichiers.For example, a file might have changes in progress when the trigger checks the file server. Pour éviter de retourner un fichier partiellement écrit, le déclencheur note l’horodatage du fichier qui comporte des modifications récentes, mais ne retourne pas immédiatement ce fichier.To avoid returning a partially written file, the trigger notes the timestamp for the file that has recent changes, but doesn't immediately return that file. Le déclencheur retourne le fichier uniquement lors d’une nouvelle interrogation du serveur.The trigger returns the file only when polling the server again. Parfois, ce comportement peut entraîner un retard correspondant à jusqu’à deux fois l’intervalle d’interrogation du déclencheur.Sometimes, this behavior might cause a delay that is up to twice the trigger's polling interval.

Se connecter à SFTPConnect to SFTP

Quand vous utilisez un déclencheur ou une action qui accède à un service pour la première fois, le concepteur Logic Apps vous invite à créer une connexion avec ce service.When you use a trigger or action that accesses a service for the first time, the Logic Apps Designer prompts you to create a connection to that service. Vous pouvez ensuite fournir les informations de connexion nécessaires directement à partir de votre application logique, à l’intérieur du concepteur.You can then provide the necessary connection information directly from your logic app inside the designer.

  1. Connectez-vous au portail Azure et ouvrez votre application logique dans le concepteur d’application logique, si elle n’est pas déjà ouverte.Sign in to the Azure portal, and open your logic app in Logic App Designer, if not open already.

  2. Pour les applications logiques vides, dans la zone de recherche, entrez « sftp » comme filtre.For blank logic apps, in the search box, enter "sftp" as your filter. Dans la liste des déclencheurs, sélectionnez le déclencheur souhaité.Under the triggers list, select the trigger you want.

    -ou--or-

    Pour les applications logiques existantes, sous la dernière étape où vous souhaitez ajouter une action, choisissez Nouvelle étape.For existing logic apps, under the last step where you want to add an action, choose New step. Dans la zone de recherche, entrez « sftp » comme filtre.In the search box, enter "sftp" as your filter. Sous la liste des actions, sélectionnez l’action souhaitée.Under the actions list, select the action you want.

    Pour ajouter une action entre des étapes, placez votre pointeur au-dessus de la flèche qui les sépare.To add an action between steps, move your pointer over the arrow between steps. Cliquez sur le signe plus ( + ) qui s’affiche, puis sélectionnez Ajouter une action.Choose the plus sign (+) that appears, and then select Add an action.

  3. Fournissez les informations nécessaires pour votre connexion.Provide the necessary details for your connection.

    Important

    Lorsque vous entrez votre clé privée SSH dans la propriété Clé privée SSH, suivez ces étapes supplémentaires pour vous assurer que vous fournissez la valeur complète et correcte pour cette propriété.When you enter your SSH private key in the SSH private key property, follow these additional steps, which help make sure you provide the complete and correct value for this property. Une clé non valide entraîne l’échec de la connexion.An invalid key causes the connection to fail.

    Bien qu’il est possible d’utiliser n’importe quel éditeur de texte, vous trouverez ici des exemples d’étapes montrant comment copier et coller correctement votre clé à l’aide de Notepad.exe.Although you can use any text editor, here are sample steps that show how to correctly copy and paste your key by using Notepad.exe as an example.

    1. Ouvrez votre fichier de clé privée SSH dans un éditeur de texte.Open your SSH private key file in a text editor. Dans cet exemple, les étapes utilisent le Bloc-notes.These steps use Notepad as the example.

    2. Dans le menu Edition du Bloc-notes, choisissez Sélectionner tout.On the Notepad Edit menu, select Select All.

    3. Sélectionnez Edition > Copier.Select Edit > Copy.

    4. Dans le déclencheur SFTP ou l’action que vous avez ajoutés, collez la clé complète que vous avez copiée dans la propriété Clé privée SSH, qui prend en charge plusieurs lignes.In the SFTP trigger or action you added, paste the complete key you copied into the SSH private key property, which supports multiple lines. Assurez-vous que vous collez la clé.Make sure you paste the key. N’entrez pas manuellement ou ne modifiez pas la clé.Don't manually enter or edit the key.

  4. Après avoir entré les informations de connexion, choisissez Créer.When you're done entering the connection details, choose Create.

  5. Fournissez les informations nécessaires pour le déclencheur ou l’action sélectionnés et continuez à générer le flux de travail de votre application logique.Provide the necessary details for your selected trigger or action and continue building your logic app's workflow.

ExemplesExamples

Déclencheur SFTP : Lors de l’ajout ou de la modification d’un fichierSFTP trigger: When a file is added or modified

Ce déclencheur démarre un flux de travail d’application logique quand un fichier est ajouté ou changé sur un serveur SFTP.This trigger starts a logic app workflow when a file is added or changed on an SFTP server. Par exemple, vous pouvez ajouter une condition qui vérifie et extrait le contenu du fichier si ce contenu répond à une condition spécifiée.For example, you can add a condition that checks the file's content and gets the content based on whether the content meets a specified condition. Vous pouvez ensuite ajouter une action qui obtient le contenu du fichier et le place dans un dossier sur le serveur SFTP.You can then add an action that gets the file's content, and puts that content in a folder on the SFTP server.

Exemple en entreprise : vous pouvez utiliser ce déclencheur pour superviser l’apparition dans un dossier SFTP de nouveaux fichiers représentant les commandes des clients.Enterprise example: You can use this trigger to monitor an SFTP folder for new files that represent customer orders. Vous pouvez ensuite utiliser une action SFTP comme Obtenir le contenu du fichier afin d’obtenir le contenu de la commande à des fins de traitement et stocker cette commande dans une base de données de commandes.You can then use an SFTP action such as Get file content so you get the order's contents for further processing and store that order in an orders database.

Action SFTP : Get contentSFTP action: Get content

Cette action obtient le contenu d’un fichier sur un serveur SFTP.This action gets the content from a file on an SFTP server. Par exemple, vous pouvez ajouter le déclencheur de l’exemple précédent et une condition à laquelle le contenu du fichier doit satisfaire.So for example, you can add the trigger from the previous example and a condition that the file's content must meet. Si la condition est vérifiée, l’action qui obtient le contenu peut s’exécuter.If the condition is true, the action that gets the content can run.

Référence de connecteurConnector reference

Pour obtenir des détails techniques sur les déclencheurs, les actions et les limites, qui sont décrits par la description OpenAPI du connecteur (anciennement Swagger), consultez la page de référence du connecteur.For technical details about triggers, actions, and limits, which are described by the connector's OpenAPI (formerly Swagger) description, review the connector's reference page.

Étapes suivantesNext steps