IP*Works! SSH sshell Component : sshell OCX, sshell .NET Component, sshell Class, sshell Bean, sshell Object

The SShell component establishes a Secure Shell connection to a server and starts up the user's default shell. Using the component is very simple. The destination is specified by the SSHHost property, and the login information is given by the SSHUser and SSHPassword properties. Then call the Connect method to establish a permanent, secure connection to the SSH server. For each command you wish to execute, simply call the Execute command or set the Command property with the command you wish to execute as the parameter. Further input can be supplied to the Text parameter of the Send method or via the Stdin property.

The output of the command is returned through the Stdout event. If an error happens on the protocol level, the error message can be found in the ErrorMessage property. Errors during command execution (the stderr stream) are given by the Stderr event.

Property List

The following is the full list of the properties of the component with short descriptions. Click on the links for complete descriptions.


Command	The command to be sent to the remote host.
Connected	Triggers a connection or disconnection.
ErrorMessage	The error message returned when any of the steps prior to command execution fail.
Firewall	A set of properties related to firewall access.
LocalHost	The name of the local host or user-assigned IP interface through which connections are initiated or accepted.
LocalPort	The TCP port in the local host where IPPort binds.
SSHAuthMode	The authentication method to be used the component when performing an SSHLogon.
SSHCert	A certificate to be used for authenticating the SSHUser.
SSHCompressionAlgorithms	A comma-separated list containing all allowable compression algorithms.
SSHEncryptionAlgorithms	A comma-separated list containing all allowable compression algorithms.
SSHHost	The address of the SSH host.
SSHPassword	The password for SSH password-based authentication.
SSHPort	The port on the SSH server where the SSH service is running; by default, 22.
SSHUser	The username for SSH authentication.
Stdin	A string of data to be sent to the remote host while connected.
Timeout	A timeout for the component. A timeout for the component.

Method List

The following is the full list of the methods of the component with short descriptions. Click on the links for complete descriptions.


Config	Sets or retrieves a component configuration setting.
DoEvents	Processes events from the internal message queue.
Execute	Execute a Command on the remote host.
SSHLogoff	Logoff from the SSH server.
SSHLogon	Logon to the SSHHost using the current SSHUser and SSHPassword.
Send	Send standard input to the program executing on the remote host.

Event List

The following is the full list of the events fired by the component with short descriptions. Click on the links for complete descriptions.


Connected	Fired immediately after a connection completes (or fails).
ConnectionStatus	Fired to indicate changes in connection state.
Disconnected	Fired when a connection is closed.
Error	Information about errors during data delivery.
SSHServerAuthentication	Fired after the server presents its public key to the client.
SSHStatus	Shows the progress of the secure connection.
Stderr	Fired when data (complete lines) come in through stderr.
Stdout	Fired when data (complete lines) come in through stdout.

Configuration Settings

The following is a list of configuration settings for the component with short descriptions. Click on the links for complete descriptions.


AbsoluteTimeout	Determines whether timeouts are inactivity timeouts or absolute timeouts.
AcceptAnyServerCert	If set the component will accept any certificate presented by the server
AuthModeList	A comma-delimited list of modes to be used during multi-factor authentication.
CloseStreamAfterTransfer	If true, the component will close the upload or download stream after the transfer.
CodePage	The system code page used for Unicode to Multibyte translations (Windows/COM only).
FirewallData	Used to send extra data to the firewall.
FirewallListener	If true, the component binds to a SOCKS firewall as a server (IPPort only).
InBufferSize	The size in bytes of the incoming queue of the socket.
MaxLineLength	The maximum amount of data to accumulate when no EOL is found.
OutBufferSize	The size in bytes of the outgoing queue of the socket.
SSHAcceptServerHostKeyFingerPrint	The fingerprint of the server key to accept
TcpNoDelay	Whether or not to delay when sending packets