Use a PuTTY Key for SSH Authentication

See more SSH Examples

Demonstrates authenticating with an SSH server using a username and a PuTTY (.ppk) private key. The key is imported with FromPuttyPrivateKey — setting Password first if it is encrypted — and passed to AuthenticatePk.

Note: The file paths are relative to the application's current working directory. Supply the paths to your own files.

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

BOOL success = NO;

//  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 a username and a PuTTY (.ppk) private
//  key.  The private key serves as the credential; the username identifies the account on the
//  server.

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

//  LoadText is a convenience method that reads any text file into a string.  It does not itself
//  load the key.
CkoSshKey *puttyKey = [[CkoSshKey alloc] init];
NSString *ppkText = [puttyKey LoadText: @"qa_data/ppk/putty_private_secret.ppk"];
if (puttyKey.LastMethodSuccess == NO) {
    NSLog(@"%@",puttyKey.LastErrorText);
    return;
}

//  Set the password before importing an encrypted .ppk.  This should come from a secure source
//  rather than being hard-coded.
puttyKey.Password = @"myKeyPassword";

success = [puttyKey FromPuttyPrivateKey: ppkText];
if (success == NO) {
    NSLog(@"%@",puttyKey.LastErrorText);
    return;
}

NSString *sshHostname = @"ssh.example.com";
int sshPort = 22;
success = [ssh Connect: sshHostname port: [NSNumber numberWithInt: sshPort]];
if (success == NO) {
    NSLog(@"%@",ssh.LastErrorText);
    return;
}

//  The corresponding public key must already be installed on the SSH server for the account.
success = [ssh AuthenticatePk: @"mySshLogin" privateKey: puttyKey];
if (success == NO) {
    NSLog(@"%@",ssh.LastErrorText);
    return;
}

NSLog(@"%@",@"Connection and authentication with the SSH server completed.");

[ssh Disconnect];