Get the SFTP Server Host Key Fingerprint

See more SFTP Examples

Demonstrates the Chilkat SFtp.GetHostKeyFP method, which returns the connected server's host-key fingerprint. The first argument is the hash algorithm (for example SHA256 or MD5), the second controls whether the key type is included, and the third controls whether the hash name is included.

Background: The host-key fingerprint identifies the server. Comparing it against a known-good value is how a client implements host-key pinning — detecting a man-in-the-middle attempt or a changed server key before trusting the connection with credentials or files. SHA256 is the modern default; MD5 fingerprints still appear in older tooling but are weaker.

Chilkat C Downloads

Download Chilkat for C

#include <C_CkSFtp.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkSFtp sftp;
    int port;
    BOOL includeKeyType;
    BOOL includeHashName;
    const char *fingerprint;

    success = FALSE;

    //  Demonstrates the SFtp.GetHostKeyFP method, which returns the server's host-key fingerprint.
    //  The 1st argument is the hash algorithm, the 2nd controls whether the key type is included, and
    //  the 3rd controls whether the hash name is included.

    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;
    }

    //  Get the SHA256 fingerprint, including the key type and hash name.
    includeKeyType = TRUE;
    includeHashName = TRUE;
    fingerprint = CkSFtp_getHostKeyFP(sftp,"SHA256",includeKeyType,includeHashName);
    if (CkSFtp_getLastMethodSuccess(sftp) == FALSE) {
        printf("%s\n",CkSFtp_lastErrorText(sftp));
        CkSFtp_Dispose(sftp);
        return;
    }

    printf("Host key fingerprint: %s\n",fingerprint);

    CkSFtp_Disconnect(sftp);


    CkSFtp_Dispose(sftp);

    }