Connectez-vous à un serveur de fichiers SFTP à partir de workflows dans Azure Logic Apps
S’applique à : Azure Logic Apps (Consommation + Standard)
Ce guide pratique explique comment accéder à votre serveur FTP (File Transfer Protocol) à partir d’un workflow dans Azure Logic Apps. 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 et utilise le protocole Secure Shell (SSH).
Dans les workflows d’application logique de consommation, vous pouvez utiliser le connecteur managéSFTP-SSH, alors que dans les workflows d’application logique standard, vous pouvez utiliser le connecteur intégré SFTP ou le connecteur managé SFTP-SSH. Vous pouvez utiliser ces opérations de connecteur pour créer des workflows automatisés qui s’exécutent quand ils sont déclenchés par des événements dans votre serveur SFTP ou dans d’autres systèmes, et exécutent des actions pour gérer les fichiers sur votre serveur SFTP. Les connecteurs managés et intégrés utilisent le protocole SSH.
Remarque
Le connecteurgéré SFTP est obsolète, les opérations de ce connecteur n'apparaissent donc plus dans le concepteur de workflow.
Par exemple, votre workflow peut commencer par un déclencheur SFTP qui surveille et traite les événements sur votre serveur SFTP. Le déclencheur rend les sorties disponibles pour les actions suivantes dans votre flux de travail. Votre workflow peut exécuter des actions SFTP qui obtiennent, créent et gèrent des fichiers via votre compte de serveur SFTP. La liste suivante inclut d’autres exemples de tâches :
- Superviser à quel moment des fichiers sont ajoutés ou changés.
- Obtenir, créer, copier, renommer, mettre à jour, lister et supprimer des fichiers.
- Créez des dossiers.
- Obtenir les métadonnées et le contenu des fichiers.
- Extraire des archives dans des dossiers.
Les étapes suivantes utilisent le portail Azure, mais avec l’extension Azure Logic Apps appropriée, vous pouvez également utiliser les outils suivants pour créer et modifier des flux de travail d’application logique :
Flux de travail d’application logique de consommation : Visual Studio ou Visual Studio Code
Flux de travail d’application logique standard : Visual Studio Code
Référence technique du connecteur
Le connecteur SFTP a différentes versions, en fonction du type d’application logique et de l’environnement hôte.
| Type d’application logique (plan) | Environnement | Version du connecteur |
|---|---|---|
| Consommation | Azure Logic Apps multilocataire | Connecteur managé, qui apparaît dans le concepteur sous l’étiquette Standard. Pour plus d’informations, consultez la documentation suivante : - Informations de référence sur les connecteurs managés SFTP-SSH - Connecteurs managés dans Azure Logic Apps |
| Consommation | Environnement de service d’intégration (ISE) | Connecteur managé, qui s’affiche dans le concepteur sous l’étiquette Standard , et la version ISE, qui s’affiche dans le concepteur avec l’étiquette ISE et présente des limites de message différentes de celles du connecteur managé. Pour plus d’informations, consultez la documentation suivante : - Informations de référence sur les connecteurs managés SFTP-SSH - Limites de messages ISE - Connecteurs managés dans Azure Logic Apps |
| Standard | Azure Logic Apps monolocataire et App Service Environment v3 (plans Windows uniquement) | Le connecteur managé apparaissant dans la galerie de connecteurs sous Runtime>partagé, ainsi que le connecteur intégré qui apparaît dans la galerie de connecteurs sous Runtime>In-App et est basé sur le fournisseur de services. Le connecteur intégré peut se connecter directement à un serveur SFTP et accéder à des réseaux virtuels Azure à l’aide d’une chaîne de connexion sans passerelle de données locale. Pour plus d’informations, consultez la documentation suivante : - Informations de référence sur les connecteurs managés SFTP-SSH - Informations de référence sur les connecteurs intégrés SFTP - Connecteurs managés dans Azure Logic Apps - Connecteurs intégrés dans Azure Logic Apps |
Limitations générales
Avant d'utiliser le connecteur géré SFTP-SSH, consultez Référence du connecteur géré SFTP-SSH - Problèmes et limitations connus.
Avant d'utiliser le connecteur intégré SFTP, consultez Référence du connecteur intégré SFTP - Problèmes et limitations connus.
Problèmes connus
Par défaut, les déclencheurs qui retournent un tableau ont un paramètre Fractionner sur déjà activé. Avec ce paramètre activé, le déclencheur décompose automatiquement le tableau en créant en interne une instance de flux de travail distincte pour traiter chaque élément du tableau. Toutes les instances de flux de travail s’exécutent en parallèle afin que les éléments du tableau soient traités en même temps.
Toutefois, lorsque le paramètre Fractionner sur est activé, les déclencheurs de connecteur managé retournent les sorties pour tous les éléments du tableau sous forme de listes. Toutes les actions suivantes qui référencent ces sorties doivent d’abord traiter celles-ci en tant que listes. Pour traiter chaque élément du tableau individuellement, vous pouvez ajouter des actions. Par exemple, pour itérer dans ces éléments de tableau, vous pouvez utiliser une boucle For each. Pour les déclencheurs qui retournent uniquement des métadonnées ou des propriétés, utilisez une action qui obtient les métadonnées de l’élément de tableau, puis une action pour obtenir le contenu des éléments.
Vous devez adopter cette approche uniquement pour les déclencheurs de connecteur managé, non pour les déclencheurs de connecteur intégré qui retournent des sorties pour un élément de tableau à la fois lorsque le paramètre Fractionner sur est activé.
Par exemple, supposons que vous avez un déclencheur de connecteur managé nommé Quand un fichier est ajouté ou modifié (propriétés uniquement) qui retourne les métadonnées ou les propriétés pour les fichiers nouveaux ou mis à jour sous forme de tableaux. Pour obtenir les métadonnées séparément pour chaque fichier, vous pouvez utiliser une boucle For each qui itère dans le tableau. Dans cette boucle, utilisez les actions de connecteur managé suivantes dans l’ordre spécifié :
Obtenir les métadonnées du fichier pour obtenir les métadonnées de chaque fichier.
Obtenir de contenu du fichier pour obtenir le contenu de chaque fichier.
Segmentation
Pour plus d’informations sur la façon dont le connecteur managé SFTP-SSH peut gérer des fichiers volumineux dépassant les limites de taille par défaut, consultez les informations de référence sur les connecteur managés SFTP-SSH - Segmentation.
Prérequis
Un compte et un abonnement Azure. Si vous n’avez pas d’abonnement Azure, inscrivez-vous pour bénéficier d’un compte Azure gratuit.
Informations de connexion et d’authentification pour accéder à votre serveur SFTP, telles que l’adresse du serveur, les informations d’identification du compte, l’accès à une clé privée SSH et le mot de passe de clé privée SSH. Pour plus d’informations, consultez les informations de référence sur les connecteurs managés SFTP-SSH - Authentification et autorisations.
Important
Lorsque vous créez votre connexion et entrez votre clé privée SSH dans la propriété de clé privée SSH, veillez à suivre les étapes permettant de fournir la valeur complète et correcte pour cette propriété. Sinon, une clé non valide entraîne l’échec de la connexion.
Le workflow d’application logique où vous souhaitez accéder à votre compte SFTP. Pour démarrer votre workflow avec un déclencheur SFTP-SSH, vous devez commencer par un workflow vide. Pour utiliser une action SFTP-SSH, démarrez votre workflow avec un autre déclencheur, tel que le déclencheur Périodicité.
Ajouter un déclencheur SFTP
Dans le Portail Microsoft Azure, ouvrez votre application logique de consommation avec un workflow vide dans le concepteur.
Dans le concepteur, suivez ces étapes générales pour ajouter le déclencheur SFTP-SSH que vous souhaitez.
Si vous y êtes invité, fournissez les informations de connexion nécessaires. Sélectionnez Créer lorsque vous avez terminé.
Une fois que la zone d’informations du déclencheur s’affiche, fournissez les informations nécessaires pour votre déclencheur sélectionné. Pour plus d’informations, consultez les informations de référence sur les déclencheurs de connecteur managé SFTP-SSH.
Lorsque vous avez terminé, enregistrez votre flux de travail. Dans la barre d’outils du Concepteur, sélectionnez Enregistrer.
Lorsque vous enregistrez votre flux de travail, cette étape publie automatiquement vos mises à jour dans votre application logique déployée, qui est en direct dans Azure. Avec un seul déclencheur, votre flux de travail vérifie simplement le serveur FTP en fonction de votre planification spécifiée. Vous devez ajouter une action qui répond au déclencheur et effectue quelque chose avec les sorties de celui-ci.
Par exemple, le déclencheur nommé Lorsqu’un fichier est ajouté ou modifié démarre un workflow lorsqu’un fichier est ajouté ou modifié sur un serveur SFTP. Comme action suivante, vous pouvez ajouter une condition qui vérifie si le contenu du fichier répond à vos critères spécifiés. Si le contenu respecte la condition, utilisez l’action nommée Obtenir le contenu du fichier pour obtenir le contenu du fichier, puis utiliser une autre action pour placer ce contenu de fichier dans un dossier différent sur le serveur SFTP.
Ajouter une action SFTP
Avant de pouvoir utiliser une action SFTP, votre workflow doit déjà commencer par un déclencheur, qui peut être de n’importe quel type de votre choix. Par exemple, vous pouvez utiliser le déclencheur intégré générique Périodicité pour démarrer votre flux de travail selon une planification spécifique.
Dans le Portail Microsoft Azure, ouvrez votre application logique Consommation avec un flux de travail dans le concepteur.
Dans le concepteur, suivez ces étapes générales pour ajouter l’action SFTP-SSH souhaitée.
Si vous y êtes invité, fournissez les informations de connexion nécessaires. Sélectionnez Créer lorsque vous avez terminé.
Une fois que la zone d’informations de l’action s’affiche, fournissez les informations nécessaires pour votre action sélectionnée. Pour plus d’informations, consultez les informations de référence sur les actions de connecteur managé SFTP-SSH.
Lorsque vous avez terminé, enregistrez votre flux de travail. Dans la barre d’outils du Concepteur, sélectionnez Enregistrer.
Par exemple, l’action nommée Obtenir le contenu du fichier à l’aide du chemin d’accès obtient le contenu d’un fichier sur un serveur SFTP en spécifiant le chemin du fichier. Vous pouvez utiliser le déclencheur de l’exemple précédent et une condition que le contenu du fichier doit satisfaire. Si la condition est vraie, une action suivante peut obtenir le contenu.
Dépannage
Pour plus d’informations, consultez la documentation suivante :
- Référence sur les connecteurs managés SFTP-SSH - Résolution des problèmes
- Référence sur les connecteurs intégrés SFTP - Résolution des problèmes