Start SSH Keyboard-Interactive Authentication

See more SSH Examples

Demonstrates the Chilkat Ssh.StartKeyboardAuth method, which begins keyboard-interactive authentication. The only argument is the login name. It returns XML describing the server's prompts and whether each response should be echoed. Answer the prompts with ContinueKeyboardAuth.

Background: Keyboard-interactive is the flexible, prompt-driven SSH method — the server sends one or more questions (a password, a one-time code, a security question) and the client answers each. It is how SSH supports two-factor and other challenge-response schemes. The returned XML tells you exactly what to ask the user and whether to mask their input.

Chilkat C Downloads

Download Chilkat for C

#include <C_CkSsh.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkSsh ssh;
    int sshPort;
    const char *infoRequestXml;

    success = FALSE;

    //  Demonstrates the Ssh.StartKeyboardAuth method, which begins keyboard-interactive
    //  authentication.  The only argument is the login name.  It returns XML describing the server's
    //  prompts and whether each response should be echoed.

    ssh = CkSsh_Create();

    //  Connect to the SSH server.  Port 22 is the usual SSH port.
    sshPort = 22;
    success = CkSsh_Connect(ssh,"ssh.example.com",sshPort);
    if (success == FALSE) {
        printf("%s\n",CkSsh_lastErrorText(ssh));
        CkSsh_Dispose(ssh);
        return;
    }

    //  Begin keyboard-interactive authentication.  The returned XML describes the prompts.
    infoRequestXml = CkSsh_startKeyboardAuth(ssh,"mySshLogin");
    if (CkSsh_getLastMethodSuccess(ssh) == FALSE) {
        printf("%s\n",CkSsh_lastErrorText(ssh));
        CkSsh_Dispose(ssh);
        return;
    }

    printf("%s\n",infoRequestXml);

    //  Answer the prompt(s) with ContinueKeyboardAuth.

    CkSsh_Disconnect(ssh);


    CkSsh_Dispose(ssh);

    }