The following protocols are available and can be selected in the configuration dialog:

• FTP: the standard FTP connection to the server using port 21
• FTP with implicit TLS¹⁾; secure connection to the server using port 990
• FTP with explicit TLS²⁾: secure connection to the server using port 21
• Secure FTP³⁾: secure connection to the server using SSH via port 22

The connection to the FTP server is established using the selected protocol. The following options have to be set in the configuration dialog of the task.

• Server: the hostname or IP at which the FTP server is available

• Port: the port number where the FTP server can be reached at - only needed if it does not correspond to the standard port of the selected protocol

• Passive connection : used when the server can not connect to the client. This is, for example, the case when the client is behind a router that changed its IP address using NAT, or if a firewall shields the client's network from outside access.
  • Note: this option is available only for standard FTP connections

• Login Type: determines which authentication fields will be offered.
  • Anonymous - can be enabled if the server supports this type of login. User and Password are not required. It can only be used with standard FTP protocol
  • User name and password - insert authentication credentials. It can be used with standard FTP as well as Secure FTP protocols. Is implied, hence not visible, with TLS protocol types.

• User Name: login name of the user for authentication against the FTP server

• Password: password of the user for authentication against the FTP server

• Private Key: a key for public/private key authentication. This key can optionally be secured with a password, which has to be set instead of the user password.

The public/private key authentication can be used with the Secure FTP protocol. The private key has to be pasted in full length into the text field. It will only be displayed once and is stored with an additional encryption together with the Taskplaner task configuration. If the private key is secured with a password, it has to be set as well and will also be stored encrypted.

Note: Errors with the encryption keys may be a hint on the wrong format of the key. It is then required to change to format to an RSA or PEM format and should look like the following block:

-----BEGIN RSA PRIVATE KEY-----
...
-----END RSA PRIVATE KEY-----

Using OpenSSH and ssh-keygen on supported systems, the following commands can be used:

[dev@localhost] $ ssh-keygen -t rsa -b 4096 -C "<User Note>"
# Generating public/private rsa key pair.
# Enter file in which to save the key (/Users/dev/.ssh/id_rsa):
# Enter passphrase (empty for no passphrase): 
# Enter same passphrase again: 
# Your identification has been saved in /Users/dev/.ssh/id_rsa.
# Your public key has been saved in /Users/dev/.ssh/id_rsa.pub.
# ...
 
[dev@localhost] $ ssh-keygen -p -f /Users/dev/.ssh/id_rsa -m pem
# ...