Connect to an SFTP Server

See more SFTP Examples

Demonstrates the Chilkat SFtp.Connect method, which establishes the SSH connection to an SFTP server. The first argument is the hostname (a DNS name or numeric IPv4/IPv6 address) and the second is the TCP port, usually 22. Connecting is the first of three setup steps.

#include <C_CkSFtp.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkSFtp sftp;
    int port;
    const char *password;

    success = FALSE;

    //  Demonstrates the SFtp.Connect method, which establishes the SSH connection to an SFTP server.
    //  The 1st argument is the hostname (a DNS name or numeric IP) and the 2nd is the TCP port.
    //  
    //  Connecting is only the first of three steps.  The full sequence is:
    //    1. Connect
    //    2. AuthenticatePw (or another authentication method)
    //    3. InitializeSftp

    sftp = CkSFtp_Create();

    //  Step 1: Connect the SSH transport.  Port 22 is the usual port.
    port = 22;
    success = CkSFtp_Connect(sftp,"sftp.example.com",port);
    if (success == FALSE) {
        printf("%s\n",CkSFtp_lastErrorText(sftp));
        CkSFtp_Dispose(sftp);
        return;
    }

    //  Normally you would not hard-code the password in source.  You should instead obtain it
    //  from an interactive prompt, environment variable, or a secrets vault.
    password = "mySshPassword";

    success = CkSFtp_AuthenticatePw(sftp,"mySshLogin",password);
    if (success == FALSE) {
        printf("%s\n",CkSFtp_lastErrorText(sftp));
        CkSFtp_Dispose(sftp);
        return;
    }

    //  Step 3: Open the SFTP subsystem.  This must be done after authentication and before any
    //  file or directory operations.
    success = CkSFtp_InitializeSftp(sftp);
    if (success == FALSE) {
        printf("%s\n",CkSFtp_lastErrorText(sftp));
        CkSFtp_Dispose(sftp);
        return;
    }

    printf("Connected, authenticated, and SFTP subsystem initialized.\n");

    CkSFtp_Disconnect(sftp);


    CkSFtp_Dispose(sftp);

    }