Click here to Skip to main content
15,886,199 members
Articles / Programming Languages / C#
Article

An FTP secure client library for C#

Rate me:
Please Sign up or sign in to vote.
4.61/5 (34 votes)
10 Dec 2008CPOL2 min read 491.9K   15.8K   135   106
How to implement an FTP secure connection with an SSL stream class.

Introduction

The purpose of this article is to create a C # FTP client in Secure mode, so if you don’t have much knowledge of FTPS, I advise you to take a look at this: FTPS.

In the .NET Framework, to upload a file in FTPS mode, we generally use the FtpWebRequest class, but you can not send commands with « quote » arguments, and even if you search on the web, you will not find a concrete example of a secured C# FTP client.

It’s for those reasons I decided to create this article.

SSL Stream?

To send a socket in Secure Socket Layer (SSL) mode, we use the class System.Net.Security.SslStream.

Provides a stream used for client-server communication that uses the Secure Socket Layer (SSL) security protocol to authenticate the server and optionally the client”.

For more information, refer to MSDN.

Using the Code

1. Pre-Authenticate

C#
FTPFactory ftp = new FTPFactory();
ftp.setDebug(true);
ftp.setRemoteHost(Settings.Default.TargetFtpSource);

//Connect to SSL Port (990)
ftp.setRemotePort(990);
ftp.loginWithoutUser();

//Send "AUTH SSL" Command
string cmd = "AUTH SSL";
ftp.sendCommand(cmd);

Before connecting to the FTP server in SSL mode, you have to define the 990 SSL port and send the « AUTH SSL » command authentication using SSL.

WelcomeFTPSecure.JPG

2. Create SSL Stream

C#
//Create SSL Stream
ftp.getSslStream();
ftp.setUseStream(true);
//Login to FTP Secure
ftp.setRemoteUser(Settings.Default.TargetFtpSecureUser);
ftp.setRemotePass(Settings.Default.TargetFtpSecurePass);
ftp.login();

ftp.getSslStream() creates an SSL stream from client socket which will be used for exchange between the client and the server FTPS. Then, you have to enter a login and password to authenticate on the FTPS server.

Note: if the SSL stream is well established, then I display all the information about the server certificate.

CertificatInfos.JPG

3. Upload File

C#
//Set ASCII Mode
ftp.setBinaryMode(false);

//Send Arguments if you want
//cmd = "site arg1 arg2";
//ftp.sendCommand(cmd);

//Upload file
ftp.uploadSecure(@"Filepath", false);

ftp.close();

Before uploading a file, you have to specify the mode: ftp.setBinaryMode(bool value).

  • value is false --> ASCII mode
  • value is true --> Binary mode

By default, it’s binary. Now, you upload the file using:

C#
ftp.uploadSecure(@"Filepath", false)

Note: you can upload in non secured mode using ftp.upload().

Points of Interest

I learned how an SSL stream and the RAW FTP communication works between a client and an FTP server. Searching on the web, I found many who were stuck on the issue of SSL communication with an FTP server, so I hope this article will be of great help.

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


Written By
Architect
Belgium Belgium
This member has not yet provided a Biography. Assume it's interesting and varied, and probably something to do with programming.

Comments and Discussions

 
QuestionExplicit FTP over TLS Pin
SoftEnd9-Jun-16 21:20
professionalSoftEnd9-Jun-16 21:20 
Question_sslStream.AuthenticateAsClient hangout Pin
Salar IB14-Mar-15 7:07
Salar IB14-Mar-15 7:07 
AnswerRe: _sslStream.AuthenticateAsClient hangout Pin
ravit2326-Mar-18 0:22
ravit2326-Mar-18 0:22 
QuestionException Pin
MehraRaj25-Dec-14 18:01
MehraRaj25-Dec-14 18:01 
GeneralBeware and use with caution Pin
Seva Zaslavsky11-Jul-14 2:03
Seva Zaslavsky11-Jul-14 2:03 
GeneralRe: Beware and use with caution Pin
Antonio Ripa1-Aug-14 11:05
professionalAntonio Ripa1-Aug-14 11:05 
SuggestionAnother library to try if you have problems with this one.... Pin
gmagana29-Jan-14 13:37
gmagana29-Jan-14 13:37 
QuestionAplication freezing after login method Pin
Leo Fraietta14-Jan-14 8:45
Leo Fraietta14-Jan-14 8:45 
Questionsftp Pin
King Ravi Kumar 14-May-13 2:13
King Ravi Kumar 14-May-13 2:13 
QuestionDoes anyone have an implemenation example ? Pin
Member 979519322-Mar-13 8:24
Member 979519322-Mar-13 8:24 
QuestionAn unknown, invalid, or unsupported option or level was specified in a getsockopt or setsockopt call Pin
Member 982113318-Feb-13 8:26
Member 982113318-Feb-13 8:26 
QuestionHow to run this program. Pin
Member 982113318-Feb-13 8:05
Member 982113318-Feb-13 8:05 
QuestionFTPS - Connecting to the server through proxy Pin
Member 251419017-Jan-13 21:19
Member 251419017-Jan-13 21:19 
QuestionWhy is the SslStream object stuff commented out? Is this truly FTP over SSL without that? Pin
andegre16-Aug-12 8:31
andegre16-Aug-12 8:31 
QuestionDir not working with secure Pin
eyedia30-May-12 7:47
eyedia30-May-12 7:47 
AnswerAre you having issues uploading and downloading files? Pin
Member 76555695-Apr-12 11:09
Member 76555695-Apr-12 11:09 
The IBM FTP server I was using this class to access was freezing when trying to upload or download files. It froze on the _sslStream.AuthenticateAsClient function. The issue turned out to be the sequence of commands sent to the server. On the IBM FTP server you have to send the RETR/STOR commands first thing after creating the data transfer socket before you call the function to create the secure stream. I've edited the class a bit, but here are the revised upload and download functions I use that work with the IBM FTP server:

NOTE: The functionality to resume has been removed because our server doesn't support it. Also, you may notice the outDelegate. This is the function used to output. You can set it to any function that returns void and takes a string (Ex: Console.WriteLine).

C#
/// <summary>
/// Upload a file to the server
/// </summary>
/// <param name="fileName">The file name (including path) of the local file to upload</param>
/// <returns>True if successful, False otherwise</returns>
public bool Upload(string fileName)
{
    // If we aren't logged in already
    if (!loggedIn)
    {
        Login(); // Login
    }

    // Create the data socket and attempt to connect
    Socket cSocket = createDataSocket();
    isData = true;

    if (outDelegate != null)
    {
        outDelegate("Data Socket Connected: " + cSocket.Connected.ToString());
        if (appendNewLines)
            outDelegate("\n");
    }

    // Send the store command to the server
    sendCommand("STOR " + Path.GetFileName(fileName));

    if (!(retValue == 125 || retValue == 150))
    {
        if (outDelegate != null)
        {
            outDelegate("Error: Bad response from server during upload: " + reply);
            if (appendNewLines)
                outDelegate("\n");
        }
        return false;
    }

    // If we were able to secure the stream
    if (getSslStream(cSocket))
    {
        // Id the data socket is connected
        if (cSocket.Connected)
        {
            byte[] bufferFile = null;
            try
            {
                // Open the local file for reading
                FileStream input = File.OpenRead(fileName);
                if (outDelegate != null)
                {
                    outDelegate("Uploading file " + fileName + " to " + remoteDir);
                    if (appendNewLines)
                        outDelegate("\n");
                }

                while (true)
                {
                    bufferFile = new byte[BLOCK_SIZE];

                    int bytes = input.Read(bufferFile, 0, bufferFile.Length); // Fill the buffer with the file
                    dataStream.Write(bufferFile, 0, bufferFile.Length); // Write the buffer to the server using the secure stream

                    // If we read less bytes than the file had left, we reached the end of the file
                    if (bytes < bufferFile.Length)
                    {
                        break;
                    }
                }

                // Close the local file
                input.Close();

                if (outDelegate != null)
                {
                    outDelegate("File successfully uploaded");
                    if (appendNewLines)
                        outDelegate("\n");
                }
            }
            catch (Exception ex)
            {
                if (outDelegate != null)
                {
                    outDelegate("Error uploading file: " + ex.Message);
                    if (appendNewLines)
                        outDelegate("\n");
                }
                return false;
            }
        }

        // Close the secure stream
        dataStream.Close();
    }

    // If the socket is still connected, close it
    if (cSocket.Connected)
    {
        cSocket.Close();
    }

    // Read and check the reply
    readReply();
    if (!(retValue == 226 || retValue == 250))
    {
        if (outDelegate != null)
        {
            outDelegate("Error: Bad response from server during upload: " + reply);
            if (appendNewLines)
                outDelegate("\n");
        }
        return false;
    }

    isData = false;
    return true;
}

/// <summary>
/// Downloads a file from the server
/// </summary>
/// <param name="remFileName">Filename of the file on the server</param>
/// <param name="locFileName">Filename (with path) of the local file</param>
/// <returns>True if successful, False otherwise</returns>
public bool Download(string remFileName, string locFileName = null)
{
    // If we aren't logged in, do so now
    if (!loggedIn)
    {
        Login();
    }

    isData = true;

    // If the local file isn't set, default it to be the same name as the server's file name
    if (locFileName == null || locFileName.Equals(""))
    {
        locFileName = remFileName;
    }

    try
    {
        // Create or open the local file for writing
        FileStream output = new FileStream(locFileName, FileMode.OpenOrCreate, FileAccess.Write);

        // Create the data socket
        Socket cSocket = createDataSocket();

        // Send the retrieve command to the server
        sendCommand("RETR " + remFileName);

        if (!(retValue == 150 || retValue == 125))
        {
            if (outDelegate != null)
            {
                outDelegate("Error: Bad response from server during download: " + reply);
                if (appendNewLines)
                    outDelegate("\n");
            }
            return false;
        }

        // Secure the stream
        this.getSslStream(cSocket);

        if (cSocket.Connected)
        {
            if (outDelegate != null)
            {
                outDelegate("Downloading file " + remFileName + " from " + remoteHost);
                if (appendNewLines)
                    outDelegate("\n");
            }

            byte[] downBuffer = new byte[1024];
            int len;
            // Read the file from the server and write it to the local file
            while ((len = dataStream.Read(downBuffer, 0, downBuffer.Length)) > 0)
            {
                output.Write(downBuffer, 0, len);
            }

            dataStream.Close();
        }

        // Close everything
        output.Close();
        if (cSocket.Connected)
        {
            cSocket.Close();
        }

        // Read the reply
        readReply();
        if (!(retValue == 226 || retValue == 250))
        {
            if (outDelegate != null)
            {
                outDelegate("Error: Bad response from server during download: " + reply);
                if (appendNewLines)
                    outDelegate("\n");
            }
            return false;
        }
    }
    catch (Exception ex)
    {
        if (outDelegate != null)
        {
            outDelegate("Error downloading file: " + ex.Message);
            if (appendNewLines)
                outDelegate("\n");
        }
        return false;
    }

    if (outDelegate != null)
    {
        outDelegate("Download Complete");
        if (appendNewLines)
            outDelegate("\n");
    }

    isData = false;
    return true;
}

GeneralRe: Are you having issues uploading and downloading files? Pin
gmagana29-Jan-14 11:26
gmagana29-Jan-14 11:26 
QuestionIndex and length must refer to a location within the string.\r\nParameter name: length Pin
Member 84911326-Mar-12 21:56
Member 84911326-Mar-12 21:56 
QuestionNo port 990 Pin
Member 855570311-Jan-12 7:02
Member 855570311-Jan-12 7:02 
AnswerRe: No port 990 Pin
bob mourning2-Mar-12 2:49
bob mourning2-Mar-12 2:49 
Questionneeds your helps Pin
Jacob P Yamarthi18-Oct-11 21:53
Jacob P Yamarthi18-Oct-11 21:53 
AnswerRe: needs your helps Pin
Member 76555695-Apr-12 10:57
Member 76555695-Apr-12 10:57 
GeneralRe: needs your helps Pin
volax12-Feb-13 5:39
volax12-Feb-13 5:39 
QuestionUpload File - Nothing Happens Pin
Sergio Marchetti22-Aug-11 12:04
Sergio Marchetti22-Aug-11 12:04 
AnswerRe: Upload File - Nothing Happens Pin
Member 76555695-Apr-12 10:56
Member 76555695-Apr-12 10:56 

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.