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

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).

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.

JavaScript errors detected

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

If this problem persists, please contact our support.