FTPS

FTPS (not to be confused with SFTP), which is also known widely as FTP Secure or FTP-SSL, is an extension to the normal File Transfer Protocol (FTP), adding the support for the cryptographic protocols Transport Layer Security (TLS) and Secure Socket Layer (SSL).

Regarding implementing this in your Designer service, connecting to an FTPS server can be done the same way as connecting to a normal FTP backend. The difference is, that you additionally need to define the FTPS protocol and the according port, method etc. in your URL adapter alias.

Alias Attributes

Find below a list of relevant alias attributes, if the URL adapter is used with the FTPS protocol. Default values used when an option is not explicitly set are written in bold.

Attribute	Description	Allowed Values / Examples
Standard
protocol	Transport protocol.	ftps
port	Machine port number the service is binding to. This port number can be given at service level only.	a valid port number (default: 21)
path	HTTP path for the SOAP request.
method	HTTP method of the URL adapter call. Default is "POST" if no value is specified.	one of: get (default), post, put, list
Advanced
user	Username/password.
options	Native cURL options as listed on Setting cURL Options on the URL Adapter. Use one of the following syntax rules: values separated by `','` in one line values separated by `' '` in one line list of tagged values	valid cURL options, e.g. `CURLOPT_TIMEOUT=20`
Proxy
proxyURL	URL of the proxy server.
proxyUser	Proxy user.
proxyType	Type of the proxy.	one of: `HTTP`, `SOCKS5`
SSL
sslCAInfo	Name of the file containing additional certificates for the connection verification (e.g. additional root CAs).
sslCertificateFile	Name of the file that contains the client certificate.
sslPrivateKeyFile	Name of the file that contains the private key.
sslPrivateKeyPassword	Password for the private key.
sslCertificateType	Type of the certificate.	one of: PEM (default), DER
sslVerifyHost	Whether to verify the host information form the SSL connection.	On	Verification on.
		Off	Verification off (default).
		Existence	Limit verification to the mere existence of the host.
sslVerifyPeer	Whether to verify the peer information from the SSL connection.	On	Verification on (default).
sslVerifyPeer		Off	Verification off.
sslPrivateKeyType	Type of the private key.	one of: PEM (default), DER

Useful cURL Options

Option	Description
`CURLOPT_SSLVERSION=CURL_SSLVERSION_SSLv2`	Via this option, you can tell the URL adapter to explicitly use SSL version 2. This may be necessary, if the server has problems with TLS/SSLv3.

There are many more cURL options, which might be needed for a service to run. You can find a comprehensive list of all cURL options supported by the xUML Runtime on Setting cURL Options on the URL Adapter.

Related Pages: