FTP Connection
FTP Connection is the resource the FTP file activities operate through. It holds the server address, the credentials, and the settings that decide how the control and data channels behave.
Three of those settings matter more than the rest. Security chooses between plain FTP and the two FTPS variants. Data Connection Mode decides whether the client or the server opens the data channel — passive works through NAT and firewalls. Transfer Mode decides whether files move as binary or as text.
The resource has two tabs: Configuration and Advanced.
Configuration
| Field | Required | Description |
|---|---|---|
| Name | Optional | Name of the resource. |
| Description | Optional | Description of the resource. |
| Host | Optional | FTP server hostname. Mapping and vault values are supported. |
| Port | Optional | Defaults to 0, which derives the port from Security. |
| Username | Optional | Login user. Use anonymous for anonymous FTP. |
| Password | Optional | Login password. Mapping and vault values are supported. |
| Security | Optional | FTP (plaintext), FTPS — Explicit (AUTH TLS), or FTPS — Implicit. Defaults to FTP (plaintext). |
| Data Connection Mode | Optional | Passive or Active. Defaults to Passive. |
| Transfer Mode | Optional | Binary or ASCII (text). Defaults to Binary. |
Derived ports
Leaving Port at 0 derives it from the security mode.
| Security | Port |
|---|---|
| FTP (plaintext) | 21 |
| FTPS — Explicit (AUTH TLS) | 21 |
| FTPS — Implicit | 990 |
Data Connection Mode
Passive works through NAT and firewalls, and is recommended.
Advanced
| Field | Required | Description |
|---|---|---|
| Control Encoding | Optional | Encoding for file names and commands. Defaults to UTF-8. |
| Connect Timeout (ms) | Optional | Defaults to 10000. |
| Data Timeout (ms) | Optional | Defaults to 30000. |
| Verify Server Certificate | Optional | FTPS only. Defaults to selected. |
| Max Connections | Optional | Defaults to 10. |
| Min Idle | Optional | Defaults to 2. |
| Max Idle | Optional | Defaults to 5. |
Max Connections, Min Idle, and Max Idle size the connection pool the FTP activities share.
Leave Verify Server Certificate on. Disabling it trusts any certificate, which exposes the connection to MITM.