TElSimpleFTPSClient.Versions property

TElSimpleFTPSClient.Versions

TElSimpleFTPSClient See also

Filter: C# VB.NET Pascal C++ PHP Java

Specifies the allowed SSL/TLS versions.

Declaration

[C#]
TSBVersions Versions;

[VB.NET]
Property Versions As TSBVersions

[Pascal]
property Versions : TSBVersions;
TSBVersions = set of TSBVersion;

[C++]
TSBVersions get_Versions();
void set_Versions(TSBVersions Value);

[PHP]
integer get_Versions()
void set_Versions(integer $Value)

[Java]
short getVersions();
void setVersions(short Value);

Parameters

Version - The value that is to be enabled or disabled. See the list of values below

Values:

[.NET]	[Pascal]	[C++]	Description
sbSSL2 = 1	sbSSL2	f_sbSSL2 = 1	SSL version 2
sbSSL3 = 2	sbSSL3	f_sbSSL3 = 2	SSL version 3
sbTLS1 = 4	sbTLS1	f_sbTLS1 = 4	TLS version 1
sbTLS11 = 8	sbTLS11	f_sbTLS11 = 8	TLS version 1.1
sbTLS12 = 16	sbTLS12	f_sbTLS12 = 16	TLS version 1.2
f_sbTLS13 = 32	sbTLS13	sbTLS13 = 32	TLS version 1.3 (RFC 8446)

TSBVersions values

[.NET][C++]	[Pascal]	[PHP]	Description
f_sbSSL2 = 1	sbSSL2	sbSSL2 = 1	SSL version 2
f_sbSSL3 = 2	sbSSL3	sbSSL3 = 2	SSL version 3
f_sbTLS1 = 4	sbTLS1	sbTLS1 = 4	TLS version 1
f_sbTLS11 = 8	sbTLS11	sbTLS11 = 8	TLS version 1.1
f_sbTLS12 = 16	sbTLS12	sbTLS12 = 16	TLS version 1.2
f_sbTLS13 = 32	sbTLS13	sbTLS13 = 32	TLS version 1.3 (RFC 8446)

Description

    This property defines which SSL/TLS versions are allowed to be used during SSL/TLS session. By default all versions are allowed. The application can disable undesired versions. It is not possible to disable SSL3 if TLS1 and SSL2 are both enabled.
    Default value is [sbTLS1, sbTLS11, sbTLS12].
     Note, if you set Versions to [sbSSL3, sbTLS1] and connect to Java 2 server which supports only TLS1, Java server will crash. This is a bug in Java 2 server.
    Note, protocol version assigning differs in VCL and .NET versions. To enable some SSL versions in .NET use bitwise OR operation, for example ‘sbSSL2 | sbSSL3 | sbTLS1’.

    Example: The following shows how to set the property for different SecureBlackbox editions:

[C#]
TElSimpleFTPSClient.Versions = SBSSLConstants.Unit.sbTLS11 | SBSSLConstants.Unit.sbTLS12;

[VB.NET]
TElSimpleFTPSClient.Versions = SBSSLConstants.Unit.sbTLS11 Or SBSSLConstants.Unit.sbTLS12

[Pascal]
TElSimpleFTPSClient.Versions = sbTLS11 or sbTLS12;