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.

AttributeDescriptionAllowed 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
userUsername/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.

OnVerification on.
OffVerification off (default).
ExistenceLimit verification to the mere existence of the host.
sslVerifyPeer

Whether to verify the peer information from the SSL connection.

OnVerification on (default).
OffVerification off.
sslPrivateKeyType

Type of the private key.

one of: PEM (default), DER

Useful cURL Options

OptionDescription
CURLOPT_SSLVERSION=CURL_SSLVERSION_SSLv2Via 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.

On this Page:
Related Pages:
  • No labels