Objective-C

Use an Existing Socket SSH Tunnel

Demonstrates the Chilkat MailMan.UseSshTunnel method, which configures MailMan to use an existing SSH tunnel provided by a Socket object for its SMTP and POP3 connections. This example opens and authenticates a tunnel on a Socket, hands it to MailMan, and then verifies an SMTP login through it.

Background: Sharing one already-established SSH tunnel across objects avoids opening (and authenticating) a separate SSH connection for every component that needs to reach the remote network. Here the tunnel lives on a Socket object, which MailMan then routes its SMTP/POP3 traffic through. It is the Socket-based sibling of UseSsh, which shares an Ssh object instead.

Chilkat Objective-C Downloads

Download Chilkat for Objective-C

Objective-C

#import <CkoSocket.h>
#import <CkoMailMan.h>

BOOL success = NO;

//  Demonstrates the MailMan.UseSshTunnel method, which configures MailMan to use an existing
//  SSH tunnel provided by a Socket object for its SMTP and POP3 connections.

//  Open and authenticate the SSH tunnel using a Socket object.
CkoSocket *sshTunnel = [[CkoSocket alloc] init];
success = [sshTunnel SshOpenTunnel: @"ssh.example.com" sshPort: [NSNumber numberWithInt: 22]];
if (success == NO) {
    NSLog(@"%@",sshTunnel.LastErrorText);
    return;
}

success = [sshTunnel SshAuthenticatePw: @"sshUser" sshPassword: @"sshPassword"];
if (success == NO) {
    NSLog(@"%@",sshTunnel.LastErrorText);
    return;
}

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

//  Configure the SMTP server connection.  These connections will travel through the tunnel.
mailman.SmtpHost = @"smtp.example.com";
mailman.SmtpPort = [NSNumber numberWithInt:465];
mailman.SmtpSsl = YES;
mailman.SmtpUsername = @"user@example.com";
mailman.SmtpPassword = @"myPassword";

//  Tell MailMan to route its connections through the existing tunnel.
success = [mailman UseSshTunnel: sshTunnel];
if (success == NO) {
    NSLog(@"%@",mailman.LastErrorText);
    return;
}

//  SMTP operations now travel through the shared SSH tunnel.
success = [mailman VerifySmtpLogin];
if (success == NO) {
    NSLog(@"%@",mailman.LastErrorText);
    return;
}

NSLog(@"%@",@"Authenticated with the SMTP server through the SSH tunnel.");