Se connecter à des fichiers sur des serveurs SFTP via Secure Shell (SSH) à partir de flux de travail dans Azure Logic Apps

S’applique à : Azure Logic Apps (Consommation + Standard)

Lorsque votre flux de travail doit effectuer une gestion automatisée et sécurisée des fichiers sur des serveurs qui utilisent le protocole SFTP (Secure Shell), utilisez les opérations de connecteur SFTP-SSH ou SFTP dans les flux de travail que vous créez avec Azure Logic Apps.

SFTP est un protocole réseau qui fournit l’accès aux fichiers, le transfert de fichiers et la gestion des fichiers sur n’importe quel flux de données fiable. Vous pouvez ensuite surveiller, transférer et gérer des fichiers sur votre serveur SFTP sans écrire de code personnalisé ni gérer l’infrastructure. Dans le cas contraire, la tentative de gestion manuelle de ces opérations de fichier peut prendre du temps, entraîner des erreurs et être difficile à mettre à l’échelle.

Par exemple, votre workflow peut effectuer les tâches suivantes :

Surveillez et traitez les fichiers de données entrants.
Créez et gérez des dossiers et des fichiers.
Obtenir les métadonnées et le contenu des fichiers. Extrayez des archives.
Distribuer des rapports.
Synchronisez le contenu entre les environnements.

Ce guide montre comment accéder à votre serveur SFTP à partir d’un flux de travail dans Azure Logic Apps.

Pour en savoir plus, consultez :

Référence technique du connecteur

Le connecteur SFTP-SSH a différentes versions, en fonction du type d’application logique et de l’environnement hôte.

Les flux de travail Consommation et Standard peuvent utiliser le connecteur SFTP-SSHgéré, qui partage le calcul avec d’autres ressources dans un environnement Azure à locataires multiples. Les flux de travail standard peuvent également utiliser le connecteur SFTP natif ou intégré au runtime. Les deux versions du connecteur utilisent le protocole SSH.

Type d’application logique (plan)	Environnement	Version du connecteur
Consommation	Azure Logic Apps multilocataire	Connecteur managé, qui apparaît dans la galerie de connecteurs sous le filtre partagé . Pour plus d’informations, consultez la référence sur le connecteur SFTP-SSH géré.
Standard	Azure Logic Apps à locataire unique, App Service Environment v3 (plan Windows uniquement) et hybride	- Connecteur managé, qui apparaît dans la galerie de connecteurs sous le filtre partagé . - Connecteur intégré, qui apparaît dans la galerie de connecteurs sous le filtre intégré 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 : - Informations de référence sur les connecteurs managés SFTP-SSH - Informations de référence sur les connecteurs intégrés SFTP

Différentes versions de connecteur SFTP offrent différentes opérations prédéfinies. Vous pouvez démarrer un flux de travail vide avec un déclencheur spécifique à SFTP ou choisir un autre déclencheur en fonction de votre scénario. Par exemple, vous pouvez démarrer votre flux de travail avec un déclencheur SFTP qui surveille et répond aux événements sur votre serveur SFTP. Le déclencheur fournit des sorties à utiliser avec les actions suivantes dans votre flux de travail. Différentes actions SFTP effectuent différentes tâches, telles que obtenir, créer et gérer des fichiers sur votre serveur SFTP.

Prérequis

Un compte et un abonnement Azure. Obtenez un compte Azure gratuit.
Informations sur la connexion et l’authentification de votre serveur SFTP :
- Adresse du serveur
- Informations d’identification du compte
- Accès à une clé privée SSH
- Mot de passe de clé privée SSH
Important

Lorsque vous créez votre connexion et entrez votre clé privée SSH dans le paramètre de clé privée SSH , veillez à suivre les étapes permettant de fournir la valeur complète et correcte du paramètre. Sinon, une clé non valide provoque l’échec de la connexion.

Pour plus d’informations, consultez les informations de référence sur les connecteurs managés SFTP-SSH - Authentification et autorisations.
Flux de travail dans lequel vous souhaitez accéder à votre serveur SFTP.

Pour démarrer votre flux de travail avec un déclencheur SFTP, vous avez besoin d’un flux de travail vide. Pour utiliser une action SFTP, utilisez n’importe quel déclencheur qui fonctionne le mieux pour votre scénario. L’exemple de ce guide utilise le déclencheur Périodicité .

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 acceptent ou qui retournent des tableaux ont souvent un paramètre Fractionner sur déjà activé. Le déclencheur débatche automatiquement un tableau en créant en interne une instance de workflow 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.

Avec le paramètre Fractionné activé, les déclencheurs de connecteur géré renvoient les résultats de tous les éléments de tableau sous forme de listes. Toutes les actions suivantes qui référencent ces sorties doivent d’abord gérer ces sorties sous forme de 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 appliquer cette approche uniquement pour les déclencheurs de connecteur géré, et non pour les déclencheurs de connecteur intégrés qui retournent des sorties pour un élément de tableau à la fois avec le paramètre Split on 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

La segmentation permet à une opération de gérer les fichiers volumineux qui dépassent les limites de taille par défaut. Pour plus d’informations sur le connecteur managé SFTP-SSH et la prise en charge du découpage, consultez Référence du connecteur managé SFTP-SSH - Découpage.

Ajouter un déclencheur SFTP

Pour ajouter un déclencheur SFTP à votre flux de travail vide, suivez les étapes correspondantes :

Ajouter un déclencheur de SFTP-SSH managé (Consommation, Standard)

Pour ajouter et configurer un déclencheur de connecteur SFTP-SSH managé ou partagé, procédez comme suit :

Dans le portail Azure, ouvrez la ressource d’application logique. Dans le concepteur, ouvrez le flux de travail vide.
Dans le concepteur, suivez les étapes générales pour ajouter le déclencheur SFTP-SSHpartagé souhaité.

Par exemple, le déclencheur SFTP-SSH nommé Lorsqu’un fichier est ajouté ou modifié démarre le flux de travail lorsqu’un fichier sur votre serveur SFTP est ajouté ou modifié. Vous pouvez ajouter une action de condition qui vérifie si le contenu du fichier répond aux critères spécifiés. Si le contenu répond aux critères, utilisez l’action SFTP nommée Obtenir le contenu du fichier, puis utilisez une autre action pour enregistrer le contenu dans un autre dossier SFTP.
Si vous y êtes invité, fournissez les informations de connexion nécessaires. Quand vous avez terminé, sélectionnez Créer nouveau.
Dans le concepteur, sélectionnez le déclencheur s’il n’est pas déjà sélectionné. Dans le volet d’informations du déclencheur, fournissez les détails nécessaires.

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.
Continuez à générer votre flux de travail en ajoutant des actions.

Ajouter un déclencheur SFTP intégré (Standard uniquement)

Pour ajouter et configurer un déclencheur de connecteur SFTP intégré, procédez comme suit :

Dans le portail Azure, ouvrez la ressource d’application logique. Dans le concepteur, ouvrez le flux de travail vide.
Dans le concepteur, suivez les étapes générales pour ajouter le déclencheur intégréSFTP souhaité.

Par exemple, le déclencheur SFTP nommé Lorsqu’un fichier est ajouté ou modifié démarre le flux de travail lorsqu’un fichier sur votre serveur SFTP est ajouté ou modifié. Vous pouvez ajouter une action de condition qui vérifie si le contenu du fichier répond aux critères spécifiés. Si le contenu répond aux critères, utilisez l’action SFTP nommée Obtenir le contenu du fichier, puis utilisez une autre action pour enregistrer le contenu dans un autre dossier SFTP.
Si vous y êtes invité, fournissez les informations de connexion nécessaires. Quand vous avez terminé, sélectionnez Créer nouveau.
Dans le concepteur, sélectionnez le déclencheur s’il n’est pas déjà sélectionné. Dans le volet d’informations du déclencheur, fournissez les détails nécessaires.

Pour plus d’informations, consultez la référence du déclencheur du connecteur intégré SFTP.
Lorsque vous avez terminé, enregistrez votre flux de travail. Dans la barre d’outils du Concepteur, sélectionnez Enregistrer.
Continuez à générer votre flux de travail en ajoutant des actions.

Ajouter une action SFTP

Avant d’ajouter une action SFTP, votre flux de travail nécessite un déclencheur, ce qui peut être le mieux adapté à votre scénario.

Cet exemple utilise le déclencheur intégré Périodicité générique, qui exécute votre workflow selon une planification spécifiée. Vous pouvez ajouter un SFTP

Ajouter une action de SFTP-SSH managée (Consommation, Standard)

Pour ajouter et configurer une action de connecteur SFTP-SSH managée, procédez comme suit :

Dans le portail Azure, ouvrez votre ressource d’application logique. Dans le concepteur, ouvrez votre flux de travail.
Dans le concepteur, suivez les étapes générales pour ajouter l’action de SFTP-SSH partagée souhaitée.

Par exemple, l’action SFTP-SSH nommée Obtenir le contenu du fichier à l’aide du chemin d’accès obtient le contenu d’un fichier à partir d’un serveur SFTP en spécifiant le chemin d’accès au fichier. Vous pouvez utiliser le déclencheur SFTP-SSH pour rechercher des fichiers nouveaux ou mis à jour et une action de condition qui spécifie les critères que le contenu doit respecter. Si le contenu répond aux critères, utilisez l'action Obtenir le contenu du fichier via le chemin, puis une action suivante afin de sauvegarder le contenu dans un autre dossier SFTP.
Si vous y êtes invité, fournissez les informations de connexion nécessaires. Quand vous avez terminé, sélectionnez Créer nouveau.
Dans le concepteur, sélectionnez l’action s’il n’est pas déjà sélectionné. Dans le volet d’informations d’action, fournissez les détails nécessaires.

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.

Ajouter une action SFTP intégrée (Standard uniquement)

Pour ajouter et configurer une action SFTP intégrée, procédez comme suit :

Dans le portail Azure, ouvrez votre ressource d’application logique. Dans le concepteur, ouvrez votre flux de travail.
Dans le concepteur, suivez les étapes générales pour ajouter l’action intégrée SFTP-SSH souhaitée.

Par exemple, l’action SFTP nommée Get file content obtient le contenu du fichier sur un serveur SFTP. Vous pouvez utiliser le déclencheur SFTP qui vérifie les fichiers nouveaux ou mis à jour et une action de condition qui spécifie les critères que le contenu du fichier doit respecter. Si le contenu répond aux critères, utilisez l’action Obtenir le contenu du fichier et une action suivante pour enregistrer le contenu dans un autre dossier SFTP.
Si vous y êtes invité, fournissez les informations de connexion nécessaires. Quand vous avez terminé, sélectionnez Créer nouveau.
Dans l'éditeur, sélectionnez l’action, si elle n’est pas sélectionnée. Dans le volet d’informations d’action, fournissez les détails nécessaires.

Pour plus d’informations, consultez les informations de référence sur les actions de connecteur intégrés SFTP.
Lorsque vous avez terminé, enregistrez votre flux de travail. Dans la barre d’outils du Concepteur, sélectionnez Enregistrer.

Résoudre les problèmes