Objective-C

SSH Keyboard Authentication

See more SSH Examples

Demonstrates how to implement keyboard authentication with an SSH server. Objective-C

#import <CkoSsh.h>
#import <NSString.h>
#import <CkoXml.h>

BOOL success = NO;

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

CkoSsh *ssh = [[CkoSsh alloc] init];

// Set some timeouts, in milliseconds:
ssh.ConnectTimeoutMs = [NSNumber numberWithInt:5000];
ssh.IdleTimeoutMs = [NSNumber numberWithInt:15000];

// Connect to the SSH server.  
// The standard SSH port = 22
// The hostname may be a hostname or IP address.
NSString *hostname = @"sftp.example.com";
int port = 22;
success = [ssh Connect: hostname port: [NSNumber numberWithInt: port]];
if (success != YES) {
    NSLog(@"%@",ssh.LastErrorText);
    return;
}

// Begin keyboard authentication..
NSString *xmlResponse = [ssh StartKeyboardAuth: @"myLogin"];
if (ssh.LastMethodSuccess != YES) {
    NSLog(@"%@",ssh.LastErrorText);
    return;
}

// If a user authentication banner was received, then your app
// may display it prior to prompting for the password.
NSLog(@"%@%@",@"UserAuthBanner: ",ssh.UserAuthBanner);

CkoXml *xml = [[CkoXml alloc] init];

success = [xml LoadXml: xmlResponse];
// Assume LoadXml succeeds for the example..
if ([xml HasChildWithTag: @"success"] == YES) {
    NSLog(@"%@",@"No password required, already authenticated.");
    return;
}

if ([xml HasChildWithTag: @"error"] == YES) {
    NSLog(@"%@",@"Authentication already failed.");
    return;
}

// See the online reference documentation for Chilkat SSH.
// The XML returned by StartKeyboardAuth will contain an infoRequest
// with one or more prompts that your application may choose to display.

// Call ContinueKeyboardAuth, passing in the whatever information is requires (such as the password).
// Typically, keyboard authentication requires one call to ContinueKeyboardAuth 
// using the password.  Theoretically, the SSH server could prompt for additional pieces
// of information.  The authentication is completed when the XML returned contains
// either a "success" or "error" child node.

// This example asumes only one call to ContinueKeyboardAuth is required.
xmlResponse = [ssh ContinueKeyboardAuth: @"myPassword"];
if (ssh.LastMethodSuccess != YES) {
    NSLog(@"%@",ssh.LastErrorText);
    return;
}

success = [xml LoadXml: xmlResponse];
// Assume LoadXml succeeds for the example..
if ([xml HasChildWithTag: @"success"] == YES) {
    NSLog(@"%@",@"SSH Keyboard Authentication Successful!");
    return;
}

if ([xml HasChildWithTag: @"error"] == YES) {
    NSLog(@"%@",@"Authentication failed.");
    return;
}