Prerequisite

• Un Braincube IoT Server
• L'application FTP/SFTP installée (voir appsmanager pour installer une nouvelle application)
• Une machine avec un serveur FTP/SFTP installé et accessible

The node settings

Une fois l'application FTP/SFTP installée, vous trouverez de nouveaux nœuds dans votre palette :

• FTP
• SFTP

FTP

FTP in

Le nœud ftp-in est conçu pour vous aider à lire des données depuis une application FTP.

Glissez-déposez facilement ce nœud depuis la palette dans votre flux de travail de données pour commencer à l'utiliser. La première chose à faire est de configurer votre serveur FTP.

Pour débuter avec ce nœud, créez un nouvel "FTP endpoint" en ouvrant le menu déroulant, sélectionnez "Add new FTP Server" puis cliquez sur le bouton "éditer". Vous accéderez alors à cette page où se trouve un onglet pour configurer la connexion :

La connexion de serveur ftp-in nécessite :

• Host : adresse IP du serveur auquel vous souhaitez vous connecter
• User : nom d'utilisateur pour l'authentification
• Password : mot de passe pour l'authentification
• Port : 21 est le port standard du protocole FTP, modifiez-le si un port spécifique est utilisé dans votre environnement
• Connection Timeout : délai d'attente (en secondes) pour établir la connexion de contrôle
• PASV Timeout : délai d'attente (en secondes) pour établir une connexion de données PASV
• Keepalive : intervalle (en secondes) d'envoi d'une commande 'dummy' (NOOP) pour maintenir la connexion active
• Data connection encryption : définir sur true pour chiffrer à la fois le contrôle et les données. Utilisé pour FTPS
• Implicit encryption : définir sur true si le serveur FTP cible utilise du FTPS pur sans chiffrement facultatif. Utilisé pour FTPS
• Secure Options : options supplémentaires à transmettre à tls.connect() au format JSON. Par exemple : {"rejectUnauthorized": true}

Une fois ces paramètres définis, cliquez sur Add, Done, Deploy pour enregistrer, puis revenez à la configuration du nœud.

Operations

• list : retourne un tableau de fichiers/dossiers dans le dossier SFTP par défaut de l'utilisateur, contenant types, noms, régulations, droits (objet), acl, propriétaire, groupe, taille et date
• get : utilise msg.payload.filename et renvoie msg.payload.filedata/code
• put : utilise msg.payload.filename et msg.payload.filedata
• delete : utilise uniquement msg.payload.filename

Dans les propriétés du connecteur, vous pouvez sélectionner un répertoire spécifique de travail dans le champ "Working Directory" ou le laisser vide pour utiliser le répertoire racine.
Si l'opération sélectionnée est get, put ou delete, spécifiez le nom du fichier dans le champ "Filename".
Il est possible de transmettre ces paramètres à l'entrée du connecteur en modifiant les clés "msg.payload.workdir" et "msg.payload.filename".

La fonction PUT permet d'envoyer un fichier du système local (le client) vers le serveur distant, de manière sécurisée sous un répertoire spécifique.
La fonction GET télécharge un fichier depuis le serveur distant vers le client local.
La fonction LIST récupère la liste des fichiers et structures de dossiers du serveur distant avec leurs métadonnées.
La fonction DELETE supprime des fichiers sur le serveur distant en toute sécurité. Prudence lors de son utilisation.

SFTP

SFTP-in

Le nœud sftp-in permet de lire des données depuis un serveur SFTP. Glissez-déposez le nœud et configurons le serveur SFTP.

Pour configurer ce nœud, créez un nouvel "SFTP endpoint" par le menu déroulant "Add new SFTP…" et cliquez sur le bouton éditer.

La connexion de serveur sftp-in requiert :

• Host : adresse IP du serveur sftp auquel vous vous connectez
• User : nom d'utilisateur pour s'authentifier
• Password : mot de passe pour s'authentifier
• Port : 22 est le port standard du protocole SFTP
• Keepalive : intervalle pour l'envoi de requêtes ping 'dummy'
• hmac : méthodes d'authentification de messages
• cipher : ensemble de chiffrements utilisables