Skip to main content
Skip table of contents

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
(protocol)

Transport protocol.

ftps

Port
(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
(path)

HTTP path for the SOAP request.

HTTP Method
(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/Password
(user)

Username/password.

Options
(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

URL
(proxyURL)

URL of the proxy server.

User)
(proxyUser)

Proxy user.

Protocol
(proxyType)

Type of the proxy.

one of: HTTP, SOCKS5

SSL

CA Info File
(sslCAInfo)

Name of the file containing additional certificates for the connection verification (e.g. additional root CAs).

Certificate File
(sslCertificateFile)

Name of the file that contains the client certificate.

Private Key File
(sslPrivateKeyFile)

Name of the file that contains the private key.

Private Key Password
(sslPrivateKeyPassword)

Password for the private key.

Certificate Type
(sslCertificateType)

Type of the certificate.

one of: PEM (default), DER

Verify Host
(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.

Verify Peer
(sslVerifyPeer)

Whether to verify the peer information from the SSL connection.

On

Verification on (default).

Off

Verification off.

Private Key Type
(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 Content

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.