Click here to Skip to main content
12,627,064 members (37,076 online)
Click here to Skip to main content
Add your own
alternative version


250 bookmarked

sharpSsh - A Secure Shell (SSH) library for .NET

, 29 Oct 2005 BSD
Rate this:
Please Sign up or sign in to vote.
A C# implementation of the SSH2 protocol.


Recently there was a need to connect to a SSH server from my C# code. I needed to perform a simple task: login to a remote Linux device, execute a command and read the response. I knew there were a number of free Java SSH libraries out there and I hoped to find a free .NET one that will allow me to do just that, but all I could find were commercial components. After experimenting with an open source Java SSH library called JSch I decided to try and port it to C# just for the sake of exercise. The result is the attached sharpSsh library and this article which explains how to use it.


SSH (Secure Shell) is a protocol to log into another computer over a network, to execute commands in a remote machine, and to move files from one machine to another. It provides strong authentication and secure communications over unsecured channels. The JSch library is a pure Java implementation of the SSH2 protocol suite; It contains many features such as port forwarding, X11 forwarding, secure file transfer and supports numerous cipher and MAC algorithms. JSch is licensed under BSD style license.

My C# version is not a full port of JSch. I ported only the minimal required features in order to complete my simple task. The following list summarizes the supported features of the library:

  • Key exchange: diffie-hellman-group-exchange-sha1, diffie-hellman-group1-sha1.
  • Cipher: 3des-cbc
  • MAC: hmac-md5
  • Host key type: ssh-rsa and partial ssh-dss.
  • Userauth: password, publickey (RSA)
  • Generating RSA key pairs.
  • Changing the passphrase for a private key.
  • SCP and SFTP

Please check my homepage for the latest version and feature list of SharpSSH.

Using the code

Let me begin with a small disclaimer. The code isn't fully tested, and I cannot guarantee any level of performance, security or quality. The purpose of this library and article is to educate myself (and maybe you) about the SSH protocol and the differences between C# and Java.

In order to provide the simplest API for SSH communication, I created two wrapper classes under the Tamir.SharpSsh namespace that encapsulates JSch's internal structures:

  • SshStream - A stream based class for reading and writing over the SSH channel.
  • Scp - A class for handling file transfers over the SSH channel.

Reading and writing data over the SSH channel

The SshStream class makes reading and writing of data over an SSH channel as easy as any I/O read/write task. Its constructor gets three parameters: The remote hostname or IP address, a username and a password. It connects to the remote server as soon as it is constructed.

//Create a new SSH stream
SshStream ssh = new SshStream("remoteHost", "username", "password");

//..The SshStream has successfully established the connection.

Now, we can set some properties:

//Set the end of response matcher character
ssh.Prompt = "#";
//Remove terminal emulation characters
ssh.RemoveTerminalEmulationCharacters = true;

The Prompt property is a string that matches the end of a response. Setting this property is useful when using the ReadResponse() method which keeps reading and buffering data from the SSH channel until the Prompt string is matched in the response, only then will it return the result string. For example, a Linux shell prompt usually ends with '#' or '$', so after executing a command it will be useful to match these characters to detect the end of the command response (this property actually gets any regular expression pattern and matches it with the response, so it's possible to match more complex patterns such as "\[[^@]*@[^]]*]#\s" which matches the bash shell prompt [user@host dir]# of a Linux host). The default value of the Prompt property is "\n", which simply tells the ReadResponse() method to return one line of response.

The response string will typically contain escape sequence characters which are terminal emulation signals that instruct the connected SSH client how to display the response. However, if we are only interested in the 'clean' response content we can omit these characters by setting the RemoveTerminalEmulationCharacters property to true.

Now, reading and writing to/from the SSH stream will be done as follows:

//Writing to the SSH channel
ssh.Write( command );

//Reading from the SSH channel
string response = ssh.ReadResponse();

Of course, it's still possible to use the SshStream's standard Read/Write I/O methods available in the System.IO.Stream API.

Transferring files using SCP

Transferring files to and from an SSH server is pretty straightforward with the Scp class. The following snippet demonstrates how it's done:

//Create a new SCP instance
Scp scp = new Scp();

//Copy a file from local machine to remote SSH server
scp.To("C:\fileName", "remoteHost", 
             "/pub/fileName", "username", "password");

//Copy a file from remote SSH server to local machine
scp.From("remoteHost", "/pub/fileName", 
               "username", "password", "C:\fileName");

The Scp class also has some events for tracking the progress of file transfer:

  • Scp.OnConnecting - Triggered on SSH connection initialization.
  • Scp.OnStart - Triggered on file transfer start.
  • Scp.OnEnd - Triggered on file transfer end.
  • Scp.OnProgress - Triggered on file transfer progress update (The ProgressUpdateInterval property can be set to modify the progress update interval time in milliseconds).

Running the examples

The demo project is a simple console application demonstrating the use of SshStream and Scp classes. It asks the user for the hostname, username and password for a remote SSH server and shows examples of a simple SSH session, and file transfers to/from a remote SSH machine.

Here is a screen shot of an SSH connection to a Linux shell:

And here is a file transfer from a Linux machine to my PC using SCP:

In the demo project zip file you will also find an examples directory containing some classes showing the use of the original JSch API. These examples were translated directly from the Java examples posted with the original JSch library and show the use of advanced options such as public key authentication, known hosts files, key generation, SFTP and others.


  • SharpSSH Homepage - New versions and bug fixes will be posted here, so please check this page for the latest updates.
  • JSch - JSch is a pure Java implementation of the SSH2 protocol suite. My C# library is based on this project.
  • - contains some great .NET projects for security and networking. I used their HMAC and Diffie Hellman classes as part of my SSH implementation.
  • Granados - A full featured open source SSH1 and SSH2 implementation in C#. I found this project after finishing my own library.


  • 2005-Oct-16
    • Initial version.
  • 2005-Oct-22
    • Fixed two bugs in Scp class.
  • 2005-Oct-29
    • Added the option to use DSA signatures ('ssh-dss') for authenticating the server during the key-exchange phase.
  • 2005-Oct-29
    • All future updates will be posted in my homepage.


This article, along with any associated source code and files, is licensed under The BSD License


About the Author

Tamir Gal
Software Developer
Israel Israel
Works as a Network Engineer for a leading networking company.

You may also be interested in...


Comments and Discussions

GeneralRe: SshExec.RunCommand returns empty string Pin
Kelevr431-Oct-08 2:02
memberKelevr431-Oct-08 2:02 
QuestionAccept an unkown host key Pin
flakzeus9-Aug-07 4:32
memberflakzeus9-Aug-07 4:32 
AnswerRe: Accept an unkown host key Pin
Tamir Gal9-Aug-07 11:47
memberTamir Gal9-Aug-07 11:47 
GeneralRemove Files after download Pin
tBSTAR6-Aug-07 12:17
membertBSTAR6-Aug-07 12:17 
GeneralRe: Remove Files after download Pin
tBSTAR3-Sep-07 8:04
membertBSTAR3-Sep-07 8:04 
GeneralRe: Remove Files after download Pin
Member 79751538-Dec-11 4:37
memberMember 79751538-Dec-11 4:37 
QuestionSharpSSH keys with OpenSsh? Pin
JohnGray19656-Aug-07 4:56
memberJohnGray19656-Aug-07 4:56 
AnswerRe: SharpSSH keys with OpenSsh? Pin
Tamir Gal6-Aug-07 5:09
memberTamir Gal6-Aug-07 5:09 
Hi John,
Could you please post an example of such key which fails with OpenSSH?

GeneralRe: SharpSSH keys with OpenSsh? Pin
JohnGray19656-Aug-07 5:55
memberJohnGray19656-Aug-07 5:55 
GeneralRe: SharpSSH keys with OpenSsh? Pin
JohnGray19656-Aug-07 6:02
memberJohnGray19656-Aug-07 6:02 
GeneralRe: SharpSSH keys with OpenSsh? Pin
Tamir Gal6-Aug-07 6:11
memberTamir Gal6-Aug-07 6:11 
GeneralRe: SharpSSH keys with OpenSsh? Pin
JohnGray19657-Aug-07 4:13
memberJohnGray19657-Aug-07 4:13 
GeneralRe: SharpSSH keys with OpenSsh? Pin
JohnGray196518-Aug-07 7:08
memberJohnGray196518-Aug-07 7:08 
GeneralRe: SharpSSH keys with OpenSsh? Pin
JohnGray196520-Aug-07 9:08
memberJohnGray196520-Aug-07 9:08 
GeneralRe: SharpSSH keys with OpenSsh? Pin
websmurf1239-Jan-08 9:29
memberwebsmurf1239-Jan-08 9:29 
GeneralRe: SharpSSH keys with OpenSsh? Pin
JohnGray19659-Jan-08 9:46
memberJohnGray19659-Jan-08 9:46 
GeneralRe: SharpSSH keys with OpenSsh? Pin
JohnGray19659-Jan-08 9:48
memberJohnGray19659-Jan-08 9:48 
GeneralRe: SharpSSH keys with OpenSsh? Pin
websmurf12310-Jan-08 0:00
memberwebsmurf12310-Jan-08 0:00 
GeneralRe: SharpSSH keys with OpenSsh? Pin
chezar8-Aug-08 1:33
memberchezar8-Aug-08 1:33 
GeneralRe: SharpSSH keys with OpenSsh? Pin
pbarrette6-Jan-09 17:43
memberpbarrette6-Jan-09 17:43 
GeneralRe: SharpSSH keys with OpenSsh? Pin
Mya Thida Than19-Aug-09 0:04
memberMya Thida Than19-Aug-09 0:04 
GeneralReport a bug and ask a question Pin
yunshu5-Aug-07 18:22
memberyunshu5-Aug-07 18:22 
GeneralUsing 64bit .NET framework Pin
sven_langenhuisen1-Aug-07 23:09
membersven_langenhuisen1-Aug-07 23:09 
GeneralRe: Using 64bit .NET framework Pin
jeganinfo8-Sep-09 0:51
memberjeganinfo8-Sep-09 0:51 
GeneralRe: Using 64bit .NET framework Pin
dstj14-Feb-10 9:41
memberdstj14-Feb-10 9:41 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Terms of Use | Mobile
Web02 | 2.8.161205.3 | Last Updated 29 Oct 2005
Article Copyright 2005 by Tamir Gal
Everything else Copyright © CodeProject, 1999-2016
Layout: fixed | fluid