Connexion au service et transfert d’un fichier en tant que commerçant ou partenaire Worldline
Il existe de nombreux clients SFTP à interface graphique populaires, dont WinSCP https://winscp.net/eng/docs/lang:fr et FileZilla https://filezilla-project.org/. Il y a aussi, bien sûr, la commande sftp de ligne de commande intégrée dans les systèmes d’exploitation comme MacOS, Windows et les distributions de Linux.
Il est également possible d’automatiser les téléversements vers un serveur SFTP à l’aide de la plupart des langages de programmation et d’une bibliothèque SSH/SFTP (p. ex., la bibliothèque Paramiko de Python).
Le service SFTP de Worldline requiert une authentification à l’aide d’une clé SSH et non d’un mot de passe.
Étape 1:
Générez une clé SSH en utilisant l’un des algorithmes suivants :
- ED25519: ssh-ed25519
- RSA: rsa-sha2-256, rsa-sha2-512
- ECDSA: ecdsa-sha2-nistp256, ecdsa-sha2-nistp384, ecdsa-sha2-nistp521
Vous trouverez des informations sur les clés SSH, y compris sur la façon de les générer, en accédant au lien ci-dessous :
https://docs.aws.amazon.com/transfer/latest/userguide/key-management.html
(en anglais seulement)
Étape 2:
Faites savoir à Worldline que vous souhaitez transférer les informations d’adresse de bénéficiaire par connexion SFTP et fournissez à Worldline la partie publique de la paire de clés générée à l’étape 1 (remarque : la clé doit être au format PEM).
Envoyez un courriel à dl-integrations.na.isv@worldline.com pour demander un accès au serveur SFTP.
Ce courriel doit contenir les informations suivantes :
- Prénom et nom de famille
- Numéro de marchand
- Adresse de courriel (il doit s’agir du courriel principal du compte)
- Clé SSH publique
Remarque : Si l’adresse électronique fournie n’est pas la même que celle du courriel principal au dossier, il faut également envoyer par courriel le consentement à l’utilisation de la nouvelle adresse électronique.
Étape 3:
Worldline créera un compte spécialement pour vous et vous fournira le nom d’utilisateur et le nom d’hôte SFTP.
Étape 4:
Pour téléverser des fichiers, connectez-vous au serveur SFTP en utilisant votre client SFTP, le nom d’utilisateur qui vous a été fourni et la partie privée de la paire de clés générée à l’étape 1.
Comment établir une connexion à l’aide du client SFTP de ligne de commande dans Windows, MacOS ou Linux :
Connectez-vous au serveur SFTP en utilisant le nom d’hôte du serveur SFTP, le nom d’utilisateur fourni au partenaire par Worldline et la clé privée SSH qui correspond à la clé publique fournie par le partenaire à Worldline. Dans cet exemple, le fichier de clé privée se trouve à ~/. ssh/id_rsa, le nom d’utilisateur est 123456789 et le nom d’hôte SFTP est biccanafe.na.bambora.com.
|
Si votre clé privée a été créée avec une phrase de passe, le client SFTP vous demandera de l’entrer :
|
Lorsque la connexion sera établie, votre répertoire de travail actuel sera votre répertoire personnel :
Connected to bicfintrac.na.bambora.com. sftp> pwd Remote working directory: / |
Utilisez la commande SFTP put pour téléverser un fichier :
sftp> put 2023-11-01_123456789_TheMerchant_10000001.csv Uploading 2023-11-01_123456789_TheMerchant_10000001.csv to 2023-11-01_123456789_TheMerchant_10000001.csv 100% 8KB 3.0MB/s 00:00 |
Erreur de connexion fermée
$ sftp -i ~/.ssh/id_rsa 123456789@bicfintrac.na.bambora.com kex_exchange_identification: Connection closed by remote host Connection closed by 100.64.1.92 port 22 Connection closed |