Skip to main content
Formulaire de configuration de la source FTP montrant les champs de connexion

Présentation

Les sources FTP et SFTP vous permettent de récupérer des fichiers de données depuis des serveurs de fichiers distants. Cela est utile pour les flux planifiés provenant de partenaires, de systèmes existants ou de toute infrastructure qui publie des données via FTP/SFTP.

Configuration FTP

Champs obligatoires

Champs optionnels

Configuration SFTP

Champs obligatoires

Authentification

SFTP prend en charge deux méthodes d’authentification :
Authentification par nom d’utilisateur et mot de passe.
Utilisez SFTP lorsque la sécurité est une préoccupation — il chiffre la connexion et tous les transferts de données. Si votre serveur SFTP prend en charge l’authentification par clé, préférez-la aux mots de passe.

Formats de fichiers pris en charge

FTP/SFTP détecte automatiquement le format du fichier. Les formats suivants sont pris en charge :
Les fichiers compressés (.gz, .zip) sont automatiquement décompressés avant le parsing.

Déchiffrement PGP

Les sources FTP et SFTP prennent en charge la récupération de fichiers chiffrés PGP. Lorsque pgpPrivateKey est configuré, les fichiers sont déchiffrés de manière transparente avant la décompression et le parsing. Les fichiers chiffrés armored (.asc) et binary (.pgp, .gpg) sont pris en charge.
Consultez le guide de déchiffrement PGP pour plus de détails sur la génération de clés, les formats pris en charge et la gestion des erreurs.

Chemins wildcards

Vous pouvez utiliser un wildcard (*) dans le nom de fichier pour correspondre à plusieurs fichiers. Cela est utile lorsque :
  • Un nouveau fichier est exporté périodiquement avec un nom différent (par ex. /exports/products_20240101.csv, /exports/products_20240102.csv)
  • Les données sont réparties sur plusieurs fichiers dans le même répertoire
Exemples de patterns :
  • /exports/products_*.csv — correspond à tous les fichiers CSV commençant par products_ dans le répertoire /exports/
  • /data/*.json — correspond à tous les fichiers JSON dans le répertoire /data/

Modes de traitement des fichiers

Lors de l’utilisation de chemins wildcards, vous pouvez configurer la manière dont les fichiers sont sélectionnés via le champ processType :

SFTP hébergé par Reelevant

Pour les Datasources configurées via la plateforme, Reelevant peut également fournir un endpoint SFTP où vos systèmes peuvent envoyer des fichiers directement. Cela est utile lorsque :
  • Votre infrastructure préfère pousser les données plutôt qu’elles soient tirées
  • Vous souhaitez mettre à jour les fichiers de données sans accéder à la plateforme Reelevant
Les identifiants SFTP (host, username, password) sont générés automatiquement lors de la création de la Datasource.

Fonctionnement

  1. Reelevant se connecte au serveur FTP/SFTP avec les identifiants fournis.
  2. Le fichier au chemin configuré est localisé. Si un wildcard est utilisé, les fichiers correspondants sont listés.
  3. Les fichiers sont téléchargés, décompressés si nécessaire, et parsés selon le format détecté.
  4. Les champs sont extraits et rendus disponibles pour le mapping.
  5. Lors des synchronisations suivantes, les fichiers sont rerécupérés selon le mode de traitement configuré.