1. Babelway
  2. Babelway User Guide
  3. Chapter 4. Manage & Build

4.2.5.5. SFTP Client Gateway Out

With a SFTP Client Out Gateway, outgoing messages are transferred to an external SFTP server.

The specific settings are:

 Server 

 External sftp server address where Babelway will send messages. 

 Username 

 Login or username to access files on this external sftp server. 

 Password 

 Password associated with the username to access account. 

 Private Key 

 The private key associated with the previous username to access your account. This can be left empty if you choose to only use the password authentication mechanism. The supported formats are RSA private key (OpenSSH format). 

 Retry  strategy 

 Allows you to determine what to do if call to remote server fails. If 'No retry' is chosen, the message will be put immediately in error. Other values allow to make some retries before setting the message in error. 

  • No retry
  • aggressive
  • Keep trying for 15 minutes
    • Will retries after 2, 4, 7, 10 and 15 minutes.
  • Keep trying for 1 hour 
    • Will retries after 2, 4, 8, 15, 30 and 60 minutes.
  • Keep trying for 3 hours 
    • Will do 6 retries in the first hour, then every hour.
  • Keep trying for 8 hours 
    • Will do 6 retries in the first hour, then every hour.
  • Keep trying for 1 day 
    • Will do 4 retries in the first hour, then every hour.
  • Keep trying for 3 days 
    • Will do 5 retries in the first 2 hours, then every 3 hours.
  • Keep trying for 5 days, once a day 
    • Will do One retry every day for 5 days at the same time as the first try.
  • Keep trying for 7 days 
    • Will do 5 retries in the first hour, then every 3 hours for 3 days, then every 6 hours.

 Directory 

 Directory where outgoing files will be stored on the server. 

 Filename 

 Filename of the outgoing message [with extension if applicable]. If empty, we will apply the default settings. 

 Filename during transfer 

 Prefix and suffix that will be prepended and appended to the file name when a file is being transferred. This mechanism is used to prevent that a file is read before it is complete. However some systems do not allow to remotely rename files or directly process and delete the file triggering an ERROR in Babelway. 

Babelway provides a unique private key per environment named Transfer that can be used in "private Key" and then share the "public key" one with the partner, For the SFTP Client Gateway Out when using the public and private key authentication mechanism.

Below in the steps that you will follow to be able to use this certificate.

1-You do need to set the private key on Babelway and share the public one with your partner, From the GATEWAY OUT (SFTP_CLIENT) select a key from the side menu of the Private Key.

mceclip3.png

SFTP Gateway Out

 

2-The public key to provide to your partner can be downloaded from Channels - Certificates - Your certificates

Your_Certificates.png

Your Certificates

 

3-By downloading the SSH version and sending it to your partner to add it into his SFTP server implemenation.

Key_Certificate_Detail.png

Key Certificate Detail

 

Note: 

  • Babelway By default connect to the remote SFTP server on port 22 but if you want to connect to this remote SFTP server using different port then use the below.
  • In the Server field add the port number you want to use it, For example if use X.X.X.X:1722 in the Server field which means connect to the remote SFTP server X.X.X.X on port 1722.
  • If there is a file name provided in the "Message In" or "Message Out" which contain ~ tilde character, All browser based on Chromium will replace the ~ tilde character by the _ underscore character when you try to download the file from the Babelway interface, For more details you can check this link https://bugs.chromium.org/p/chromium/issues/detail?id=479419
  • The maximum file size accepted by this gateway is 100/250 MB.