A simple FTP to SFTP bridge
Project description
ftp2sftp - A simple FTP to SFTP bridge
Usecase
FTP is a protocol that was introduced in the 80's and today has the major problem of non-encrypted communication. Due to this problem, today there are two well-known advancements of the protocol: FTPS and SFTP. Unfortunately, there are still legacy systems in the wild that can only communicate with FTP servers. Depending on the importance and maintenance possibilities of the system, the function of working with one of the encrypted variants cannot be implemented with a realistic effort. If no middleware is then available, there are few options. This is where ftp2sftp comes in and reveals a way to enable communication via SFTP without having to make major changes to the legacy system.
How ftp2sftp works
ftp2sftp itself starts an FTP server to which an FTP client (for example the legacy system) can connect. But in the background a connection to a SFTP server is established after a successful login on the FTP server. All information that the FTP client receives actually comes from the SFTP server. They are passed through directly in both directions. This also means that if the FTP client uploads a file, for example, and receives feedback from ftp2sftp that the file has been successfully transferred, the client can be sure that the file has actually arrived on the SFTP server.
If the FTP client (for example, the legacy system) and ftp2sftp are running on the same machine or at least on the same network, and the target SFTP server is only accessible via the Internet, it can thus be ensured that the data transfer via the Internet is appropriately encrypted using the SFTP protocol.
How to install ftp2sftp
ftp2sftp is a Python 3 module. You can install it like every other one with pip:
pip install --upgrade pdf2sftp
Windows special
While installing not .exe files is still a mystery for some windows users, I created another repository to hold .exe files which were created using pyinstaller. If you want to run ftp2sftp as a service, you should take a look to nssm, what is a easy way to run any programs as a service.
How to use ftp2sftp
Command line arguments
We imagine the following situation:
A legacy software is configured to connect to an FTP server connected at the following URL: 127.0.0.1:21
as user ftp-user
and password secret
. The software also expects it to write to the following directory as its home directory: /home/ftp-user
.
The bridge should connect to your SFTP server, which can be reached at external-sftp-server:22
. It should connect with the user sftp-user
and the password 1234512
. On the SFTP server /home/sftp-user
is the home directory.
Also, a log is to be written to the /log/ftp2sftp
directory.
For this configuration you have to call ftp2sftp with this arguments:
pdf2sftp --ftp ftp-user:secret@127.0.0.1:21:/home/ftp-user --sftp sftp-user:1234512@external-sftp-server:22:/home/sftp-user --logdir /log/ftp2sftp
Both, the --ftp
and the --sftp
parameter have the same format: username:password@host:port:/homedirectory
. Note: the homedirectory can also be something like /
. It depends on the server or client configuration.
You can see the all command line arguments by using --help
.
Store command line arguments in a textfile
You can store your command line options in a textfile. For the example above it could contain the following data:
--ftp
ftp-user:secret@127.0.0.1:21:/home/ftp-user
--sftp
sftp-user:1234512@external-sftp-server:22:/home/sftp-user
--logdir
/log/ftp2sftp
Whe you do so, your only paramter to ftp2sftp could be the path to the file with a as
prefix. If your configuration is in /etc/ftp2sftp.conf
you can call ftp2sftp like this:
ftp2sftp @/etc/ftp2sftp.conf
So it will read its command line arguments from the file.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.