SslMode Property

Visual Basic
C#
C++/CLI

'Declaration
 
Public Property SslMode As String

'Usage
 
Dim instance As TdConnectionStringBuilder
Dim value As String
 
instance.SslMode = value
 
value = instance.SslMode

public string SslMode {get; set;}

public:
property String^ SslMode {
   String^ get();
   void set (    String^ value);
}

This feature is only available with Teradata SQL Engine 16.20.53.30 and above, and TLS must be enabled on the Gateway.

NOTE: The Data Provider only checks the certificate revocation status during authentication if SslMode is Verify-Full. The certificate status is not checked with other values of SslMode.

SslMode	Description
Disable	Disable HTTPS/TLS connections and only connect using the non-TLS TdConnectionStringBuilder.PortNumber. If the TdConnectionStringBuilder.DataEncryption parameter is set, then TeraGSS is used for encryption.
Allow	If the server does not require HTTPS/TLS connections, connect using the non-TLS TdConnectionStringBuilder.PortNumber. If the TdConnectionStringBuilder.DataEncryption parameter is set, then TeraGSS is used for encryption. If the server requires HTTPS/TLS connections, establish a TLS-encrypted connection using the TdConnectionStringBuilder.HttpsPortNumber.
Prefer	If the server supports HTTPS/TLS connections, establish a TLS-encrypted connection using the TdConnectionStringBuilder.HttpsPortNumber. If the server does not support HTTPS/TLS connections, connect using the non-TLS TdConnectionStringBuilder.PortNumber. If the TdConnectionStringBuilder.DataEncryption parameter is set, then TeraGSS is used for encryption.
Require	Establish a TLS-encrypted connection using the TdConnectionStringBuilder.HttpsPortNumber.
Verify-CA	Establish a TLS-encrypted connection using the TdConnectionStringBuilder.HttpsPortNumber and verify that the server certificate is valid and trusted by the Certificate Authority (CA) certificates installed on the client system.
Verify-Full	Establish a TLS-encrypted connection using the TdConnectionStringBuilder.HttpsPortNumber, verify that the server certificate is valid and trusted by the certificates installed on the client system, and verify that the server certificate contains the TdConnectionStringBuilder.DataSource in the Common Name or the Subject Alternative Name. The certificate revocation status is checked for all the certificates, and the connection is terminated if any of the certificates in the certificate chain were revoked. If the revocation status is anything other than revoked or cannot be determined, the behavior is controlled by the TdConnectionStringBuilder.SslCRC property.

Default Value: Prefer

Product	Versions	Platforms
.NET	6, 7	Windows, Linux, MacOS
.NET Framework	4.6.2, 4.7, 4.7.1, 4.7.2, 4.8	Windows
.NET Standard	2.0	Windows, Linux, MacOS

Reference

TdConnectionStringBuilder Class
TdConnectionStringBuilder Members