SecureProtocol Property  
 

Gets and sets the security protocol used to establish the secure connection with the server.

Syntax

object.SecureProtocol [= protocol ]

Remarks

The SecureProtocol property can be used to specify the security protocol to be used when establishing a secure connection with a server. By default, the control will attempt to use either SSH-1 or SSH-2 to establish the connection, with the appropriate protocol automatically selected based on the capabilities of the server. It is recommended that you only change this property value if you fully understand the implications of doing so. Assigning a value to this property will override the default and force the control to attempt to use only the protocol specified. One or more of the following values may be used:

Value Constant Description
0 stProtocolNone No security protocol has been selected. Because all connections to an SSH server are secure, this value indicates that a connection has not been established.
16 stProtocolSSH1 The Secure Shell 1.0 protocol has been selected. This version of the protocol has been deprecated and is no longer widely used. It is not recommended that this version of the protocol be used to establish a connection.
32 stProtocolSSH2 The Secure Shell 2.0 protocol has been selected. This is the most commonly used version of the protocol. It is recommended that this version of the protocol be used unless the server explicitly requires the client to use an earlier version.

Multiple security protocols may be specified by combining them using a bitwise Or operator. After a connection has been established, reading this property will identify the protocol that was selected to establish the connection. Attempting to set this property after a connection has been established will result in an exception being thrown. This property should only be set before calling the Connect method.

Data Type

Integer (Int32)

See Also

CipherStrength Property, HashStrength Property, Secure Property, SecureCipher Property, SecureHash Property, SecureKeyExchange Property