ContentConnector

Secure FTP Mini Guide

1. Configuration

Switching the ContentConnector to SFTP mode doesn’t require any code changes, it can be done simply by modifying the ContentConnector.xml file as shown below.

1.1 SFTP domain name

Set the FTPURL parameter to sftp.cs.1worldsync.com under the /ContentConnector/DataFeedConfiguration/DS element. The modified element should look like this:

1.2 Enable SFTP option

Uncomment or add the option “SecureFTP” under the /ContentConnector/DataFeedConfiguration element. The modified element should look like this:

2. Environment

Now that the ContentConnector is configured to use SFTP, it will raise an error unless the environment is properly configured. To do this, the sftp fingerprint needs to be added to a known_hosts file, which can be achieved using a simple command line in any unix-like prompt.

2.1 Open a compatible shell

Under Linux or Mac, any prompt can be used. Under Windows, you’ll need to use WSL, or alternatively you can install Git for Windows just to use the Git bash.

2.2 Add fingerprint to known_hosts

Within an appropriate shell, use cd commands to change the current directory to where the ContentConnector jar file is located. Once inside the right directory, add the host using the following command:

The above line will create a known_hosts in the same directory where the jar file is located, after which you can simply use the  [path-to-java\]java -jar ContentConnector-2.2.22.jar  command as usual since you’re already in the right directory.

⚠ If You’re having trouble generating a known_hosts file, you can download one from here that is valid at the time of writing this guide. It must be placed in the same directory as the ContentConnector‑X.Y.Z.jar file as per instructions above, before executing the  java -jar  command.
In Powershell you can also simply download the known_hosts file directly to the ContentConnector directory using these commands:
PS> $url = "https://drive.google.com/uc?export=download&id=1A1-HVhaAlvKTiZcqSN4dpp3PLFFhU934"
PS> Invoke-WebRequest -Uri $url -OutFile .\known_hosts

2.3 Verify firewall/network security

SFTP uses port 22. Ensure that outbound traffic is allowed to sftp.cs.1worldsync.com over this port. This may require contacting your domain administrator or changing firewall settings in the machine running the ContentConnector, or both.