FTP / SFTP
Liste, télécharge, dépose, renomme ou supprime des fichiers sur un serveur FTP, FTPS ou SFTP.
Fonctionnement
Une opération par élément, sur une connexion ouverte pour l'ensemble des éléments. FTPS chiffre la connexion (TLS explicite ou implicite, certificat vérifié). SFTP passe par une connexion SSH dont l'empreinte de la clé d'hôte est vérifiée. Adresses : mêmes règles que les blocs Serveurs (réseaux privés autorisés, métadonnées et services de la plateforme refusés).
Paramètres
| Paramètre | Type | Détail |
|---|---|---|
| Protocole | choix | Valeurs : FTP ou FTPS, SFTP (SSH). |
| Connexion FTPobligatoire · selon les autres paramètres | connexion | Connexion enregistrée de l'organisation. |
| Connexion SSHobligatoire · selon les autres paramètres | connexion | Empreinte de la clé d'hôte vérifiée à chaque connexion. |
| Opération | choix | Valeurs : Lister un dossier, Télécharger un fichier, Déposer un fichier, Renommer ou déplacer, Supprimer un fichier, Créer un dossier. |
| Chemin distantobligatoire | texte | — |
| Nouveau cheminobligatoire · selon les autres paramètres | texte | — |
| Inclure les sous-dossiersselon les autres paramètres | oui / non | 500 entrées au plus. |
| Contenu déposéselon les autres paramètres | choix | Valeurs : Fichier joint à l'élément, Texte. |
| Fichier (propriété binaire)obligatoire · selon les autres paramètres | texte | — |
| Texte déposéobligatoire · selon les autres paramètres | texte long | — |
| Créer les dossiers manquantsselon les autres paramètres | oui / non | — |
| Délai maximal (secondes) | nombre | 300 s au plus. |
Données reçues et renvoyées
- EntréeListe d'éléments.
- SortieLister : un élément par entrée { name, path, type, size, modifiedAt }. Télécharger : l'élément avec le fichier joint. Autres : { path, ok }.
Erreurs
Identifiants refusés, empreinte SSH différente, fichier absent, fichier téléchargé de plus de 2 Mo, délai dépassé, adresse refusée.
À savoir. FTP sans TLS transmet le mot de passe en clair : préférez FTPS ou SFTP.
Exemple
Paramètres d'un bloc prêt à l'emploi. Dans l'éditeur, l'onglet Aide du bloc applique cet exemple en un clic.
{
"protocol": "sftp",
"operation": "upload",
"path": "/depot/{{ $json.fileName }}",
"source": "binary",
"binaryField": "data",
"createDirs": true
}