Objective-C

SSH Tunnel for Database Connection (such as ADO, ODBC, JDBC, etc.)

See more SSH Tunnel Examples

Demonstrates how to create an SSH tunneling client in a background thread of your application. This makes it possible to SSH tunnel database connections without the need for separate software (such as PuTTY) to be running. Objective-C

#import <CkoSshTunnel.h>
#import <NSString.h>

BOOL success = NO;

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

success = NO;

CkoSshTunnel *tunnel = [[CkoSshTunnel alloc] init];

NSString *sshHostname = @"sftp.example.com";
int sshPort = 22;

//  Connect to an SSH server and establish the SSH tunnel:
success = [tunnel Connect: sshHostname port: [NSNumber numberWithInt: sshPort]];
if (success != YES) {
    NSLog(@"%@",tunnel.LastErrorText);
    return;
}

//  Authenticate with the SSH server via a login/password
//  or with a public key.  
//  This example demonstrates SSH password authentication.
success = [tunnel AuthenticatePw: @"mySshLogin" password: @"mySshPassword"];
if (success != YES) {
    NSLog(@"%@",tunnel.LastErrorText);
    return;
}

//  The destination host/port is the database server.
//  The DestHostname may be the domain name or 
//  IP address (in dotted decimal notation) of the database
//  server.
tunnel.DestPort = [NSNumber numberWithInt:1433];
tunnel.DestHostname = @"myDbServer.com";

//  Start accepting connections in a background thread.
//  The SSH tunnels are autonomously run in a background
//  thread.  There is one background thread for accepting
//  connections, and another for managing the tunnel pool.
int listenPort = 3316;
success = [tunnel BeginAccepting: [NSNumber numberWithInt: listenPort]];
if (success != YES) {
    NSLog(@"%@",tunnel.LastErrorText);
    return;
}

//  At this point the app may connect to the database server through
//  the SSH tunnel.  The database connection string would
//  use "localhost" for the hostname and 3316 for the port.
//  We're not going to show the database coding here,
//  because it can vary depending on the API you're using
//  (ADO, ODBC, OLE DB, etc. )

//  This is where the application's database code would go...

//  Stop the background listen/accept thread:
BOOL waitForThreadExit = YES;
success = [tunnel StopAccepting: waitForThreadExit];
if (success != YES) {
    NSLog(@"%@",tunnel.LastErrorText);
    return;
}

//  Close the SSH tunnel (would also kick any remaining connected clients).
success = [tunnel CloseTunnel: waitForThreadExit];
if (success != YES) {
    NSLog(@"%@",tunnel.LastErrorText);
    return;
}