(Objective-C) POP3 over Multiple Hop SSH

Demonstrates how to read POP3 email (using TCP or TLS) tunneled through mulitple-hop SSH. The scheme looks like this:

Application => ServerSSH1 => ServerSSH2 => POP3Server

Chilkat Objective-C Library Downloads MAC OS X (Cocoa) Libs iOS Libs

#import <CkoSsh.h>
#import <CkoMailMan.h>
#import <CkoEmail.h>

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

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

// Connect directly to the 1st SSH server.
BOOL success = [ssh1 Connect: @"serverssh1.com" port: [NSNumber numberWithInt: 22]];
if (success != YES) {
    NSLog(@"%@",ssh1.LastErrorText);
    return;
}

// Authenticate using login/password:
success = [ssh1 AuthenticatePw: @"ssh1Login" password: @"ssh1Password"];
if (success != YES) {
    NSLog(@"%@",ssh1.LastErrorText);
    return;
}

// Connect through the 1st SSH connection to reach a 2nd SSH server.
// Note: Any number of SSH connections may be simultaneously tunneled through a single
// existing SSH connection.
CkoSsh *ssh2 = [[CkoSsh alloc] init];
success = [ssh2 ConnectThroughSsh: ssh1 hostname: @"serverssh2.com" port: [NSNumber numberWithInt: 22]];
if (success != YES) {
    NSLog(@"%@",ssh2.LastErrorText);
    return;
}

// Authenticate with ssh2...
success = [ssh2 AuthenticatePw: @"ssh2Login" password: @"ssh2Password"];
if (success != YES) {
    NSLog(@"%@",ssh2.LastErrorText);
    return;
}

CkoMailMan *mailman = [[CkoMailMan alloc] init];

// Tell the mailman object to connect to the POP3 server though the ssh2 tunnel (which itself is routed through ssh1).
// The connection looks like this:  Application => ServerSSH1 => ServerSSH2 => POP3Server
success = [mailman UseSsh: ssh2];
if (success != YES) {
    NSLog(@"%@",mailman.LastErrorText);
    return;
}

// Set the POP3 server's hostname
mailman.MailHost = @"pop.someMailServer.com";

// Set the POP3 login/password.
mailman.PopUsername = @"myLogin";
mailman.PopPassword = @"myPassword";

// Establish the POP3 connection through the ssh2 tunnel.
success = [mailman Pop3BeginSession];
if (success != YES) {
    NSLog(@"%@",mailman.LastErrorText);
    return;
}

// Get the number of messages in the mailbox.
int numMessages = [[mailman GetMailboxCount] intValue];

int i = 1;

CkoEmail *email = 0;
while (i <= numMessages) {

    email = [mailman FetchByMsgnum: [NSNumber numberWithInt: i]];
    if (mailman.LastMethodSuccess != YES) {
        NSLog(@"%@",mailman.LastErrorText);
        return;
    }

    NSLog(@"%@%@%@%@",email.From,@": ",email.Subject,@"\n");

    i = i + 1;
}

// Close the connection with the POP3 server.  (This closes the tunnel through ssh2)
// The connection with ssh2 is still alive, and may be used for more connections.
success = [mailman Pop3EndSession];

// Close the connection with ssh2.  (This closes the the tunnel through ssh1.)
// The connection with ssh1 is still alive, and may be used for more connections.

[ssh2 Disconnect];

[ssh1 Disconnect];