FTP connected service

  • Published on Feb 5, 2025
  • 1 minute(s) read
  • Migration Team
 Prev Next

In our system it is possible to configure FTP, FTPS, FTPES or SFTP connection to import field and file content.

Feature flag

Property name

In webapp.yaml

Value format

enable.connections.ftp

starting from 9.102.0

encode:

 webapp:

   connections:

     list:  

     - type: FTP

       enabled-sites: '*'

[*] | [SiteID]

Starting from v.19.0.0 "FTP" feature flag is not needed to enable/disable "FTP Connected Service"!!!

"FTP Connected Service" will be always enabled for all sites by default.

FTP Service Configuration

ca6370c4f0__1_.jpg

Parameter

Description

Service Name

Descriptive name of the integration service

Account

You can select from existing accounts or leave “Create new…” to create the new one on this step

Account Name

Descriptive name of the connected account

FTP Type

FTP

SFTP

FTPS

FTPES

FTPS and FTPES are supported only in mode force_local_data_ssl=NO

Unfortunately, we could not test cases with FTPS and FTPES connections. There are problems with configuration of our server. 

What we reccomend:

  • if security is important to the client - use sftp,

  • if not - use ftp.

The ftps / ftpes option has a serious compatibility issue with Java security.
Problem - Java uses a separate security channel for each new port. And in ftps / ftpes - 2 ports are used. And in the default settings, the server wants the session to be one, and Java does two.

URL

URL to FTP system you want to connect. FTP URL scheme and FTP Type should match

User Name

User login name

Password

User password

Connection Timeout

Time during which system is trying to get a response from FTP. If the time elapsed and no response received, the timeout message will be shown

Timeout Message

A message to be displayed if FTP is not available during the specified timeout

Connection Mode

PASSIVE (The client issues a PASV command to indicate that it will wait “passively” for the server to supply an IP and port number, after which the client will create a Data Connection to the server.)

ACTIVE (The client issues a PORT command to the server signaling that it will “actively” provide an IP and port number to open the Data Connection back to the client.)

*Field becomes hidden when SFTP type is selected

Encoding

UTF-8

ISO-8859-1

*Field becomes hidden when SFTP type is selected

Transfer data type

Binary

ASCII

*Field becomes hidden when SFTP type is selected

Data Timeout

Time during which system is waiting to read data

*Field becomes hidden when SFTP type is selected

On saving the service, system validates connection to the server. Correspondent message appears if connection fails:

6a9e74541c.jpg

Note! Service will not be saved with failed connection, but account will. In this case, account can be edited only from Connected Accounts list.

Once the service is configured, it can be used in Scheduled Import action.  

Related articles