Unicode C

SSH Public Key Authentication

Demonstrates authenticating with an SSH server using public-key authentication. A private key is loaded into an SshKey object and passed to AuthenticatePk. The matching public key must already be installed on the server for the account.

Note: The private-key path is relative to the application's current working directory. Supply the path to your own key file.

Background: Public-key authentication is the standard for unattended and automated SSH: the private key never leaves the client, the server merely trusts the corresponding public key, and no reusable password crosses the wire. SshKey imports several formats — OpenSSH PEM keys via FromOpenSshPrivateKey and PuTTY .ppk files via FromPuttyPrivateKey — encrypted or not. For an encrypted key, set the Password property before importing. Note that LoadText is only a convenience for reading a text file into a string; it does not itself load the key.

Chilkat Unicode C Downloads

Download Chilkat for Unicode C

Unicode C

#include <C_CkSshW.h>
#include <C_CkSshKeyW.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkSshW ssh;
    const wchar_t *hostname;
    int port;
    HCkSshKeyW key;
    const wchar_t *privKeyText;

    success = FALSE;

    //  This example requires the Chilkat API to have been previously unlocked.
    //  See Global Unlock Sample for sample code.

    //  Demonstrates authenticating with an SSH server using public-key authentication.  The matching
    //  public key must already be installed on the SSH server for the account.

    ssh = CkSshW_Create();

    //  Timeouts, in milliseconds.
    CkSshW_putConnectTimeoutMs(ssh,5000);
    CkSshW_putReadTimeoutMs(ssh,15000);

    hostname = L"ssh.example.com";
    port = 22;
    success = CkSshW_Connect(ssh,hostname,port);
    if (success == FALSE) {
        wprintf(L"%s\n",CkSshW_lastErrorText(ssh));
        CkSshW_Dispose(ssh);
        return;
    }

    //  LoadText is a convenience method that reads any text file into a string.  It does not itself
    //  load the key.
    key = CkSshKeyW_Create();
    privKeyText = CkSshKeyW_loadText(key,L"qa_data/my_private_key.pem");
    if (CkSshKeyW_getLastMethodSuccess(key) == FALSE) {
        wprintf(L"%s\n",CkSshKeyW_lastErrorText(key));
        CkSshW_Dispose(ssh);
        CkSshKeyW_Dispose(key);
        return;
    }

    //  Import the private key.  Both OpenSSH and PuTTY formats are supported, encrypted or not.
    //  This example loads an unencrypted OpenSSH-format key; for a PuTTY .ppk file, call
    //  FromPuttyPrivateKey instead.  For an encrypted key, set key.Password before importing.
    success = CkSshKeyW_FromOpenSshPrivateKey(key,privKeyText);
    if (success == FALSE) {
        wprintf(L"%s\n",CkSshKeyW_lastErrorText(key));
        CkSshW_Dispose(ssh);
        CkSshKeyW_Dispose(key);
        return;
    }

    success = CkSshW_AuthenticatePk(ssh,L"mySshLogin",key);
    if (success == FALSE) {
        wprintf(L"%s\n",CkSshW_lastErrorText(ssh));
        CkSshW_Dispose(ssh);
        CkSshKeyW_Dispose(key);
        return;
    }

    wprintf(L"Public-key authentication successful.\n");

    CkSshW_Disconnect(ssh);


    CkSshW_Dispose(ssh);
    CkSshKeyW_Dispose(key);

    }