Copyright © Cloud Software Group, Inc. All Rights Reserved

FTP Connection

Shared Configuration

The FTP Connection shared configuration resource describes a connection to an FTP server. FTP connections are used when configuring activities in the FTP palette.

Configuration

The Configuration tab has the following fields.

Field	Description
Name	The name to appear as the label for the resource.
Description	Short description of the shared resource.
SSL	Specifies to use the HTTPS (secure socket layer or SSL) protocol for the FTP connection. This protocol authenticates the FTP client to the server. Enabling this field allows you to specify SSL parameters with the Configure SSL button (described in Configure SSL Button).
Host	Host name or IP address of the FTP server.
Port	Port number of the FTP server. For connections inside of a firewall, 21 is the default when no value is specified in this field.
User Name	User name to use when logging into the FTP server.
Password	Password to use when logging into the FTP server.
Mode	Specifies whether to use Active or Passive mode to connect to the FTP server.
Connection Timeout (msec)	The timeout specified in this field (in milliseconds) applies to the following situations: • Making the control socket connection to the FTP Server • Making the data socket connection to the FTP server (passive mode) • Waiting for the data socket connection from the FTP server (active mode) • Reading a reply from control socket after sending a FTP control command. • Reading data from data socket. If the specified time is reached when attempting any of these operations, the activity using this FTP connection terminates without error and takes any matching success transitions to the next activity in the process definition.
Remote Filename Encoding	A drop down list of values for specifying the character encoding of file names supplied to FTP commands using this connection. The encoding specified in this field is used when sending path and file names supplied to FTP commands that use this FTP Connection resource. Set this field when the FTP server has a different system encoding than the machine where the process engine is running.
Firewall	Specifies whether the FTP host resides outside of a firewall. If this field is checked, you must supply the Proxy Host and Proxy Port fields with the name and the port of the proxy server used to access sites outside of a firewall. You can optionally specify the User Name and Password for the proxy server, if necessary.
Proxy Host	Used when the remote FTP server is outside of a firewall. Specifies the host name or IP address of the firewall server.
Proxy Port	Used when the remote FTP server is outside of a firewall. Specifies the port number of the firewall server.
Proxy User Name	Used when the remote FTP server is outside of a firewall. Specifies the user name to use to connect to the proxy server, if necessary.
Proxy Password	Used when the remote FTP server is outside of a firewall. Specifies the password to use for the specified user name when connecting to the proxy server, if necessary.

Configure SSL Button

The Configure SSL button allows you to specify the SSL parameters for the HTTP connection. The following are the fields in the SSL Configuration for HTTPS Connections dialog:

Field	Description
Trusted Certificates Folder	Specifies a folder in the project containing one or more certificates from trusted certificate authorities. This folder is checked when a client connects to ensure that the server’s certificate is from a trusted certificate authority. This prevents connections from rogue servers.
Identity	An Identity resource that contains the HTTP server’s digital certificate and private key. See TIBCO Designer Palette Reference for more information.
Verify Host Name	Specifies to check that the host name of the FTP server against the host name listed in the server’s digital certificate. This provides additional verification that the host name you believe you are connecting to is in fact the desired host. If the host name specified in the Host field on the Configuration tab is not an exact match to the host name specified in the server’s digital certificate, the connection is refused. Note: If you specify an equivalent hostname (for example, an IP address) in the Host field, but the name is not an exact match of the hostname in the host’s digital certificate, the connection is refused.
Strong Cipher Suites Only	When checked, this field specifies that the minimum strength of the cipher suites used can be specified with the bw.plugin.security.strongcipher.minstrength custom engine property. See TIBCO ActiveMatrix BusinessWorks Administration for more information about this property. The default value of the property disables cipher suites with an effective key length below 128 bits. When this field is unchecked, only cipher suites with an effective key length of up to 128 bits can be used.

Test Connection Button

When the Test Connection button is clicked, BusinessWorks attempts to connect to the specified remote FTP server on the specified port using the specified username and password. You can use this button to determine if the specified connection configuration is correct.

Available Commands Button

The Available Commands button displays a dialog with details about which FTP commands are available on the specified remote server. FTP servers on different operating systems and from different vendors support slightly different commands. You can use this button to determine which commands are available on the remote FTP server before attempting to execute them with the FTP Quote activity.

Copyright © Cloud Software Group, Inc. All Rights Reserved