Objective-C

REST through SSH Tunnel

See more REST Examples

Demonstrates how to connect through an SSH Tunnel (via port-forwarding) to make REST API calls. Objective-C

#import <CkoSocket.h>
#import <NSString.h>
#import <CkoRest.h>
#import <CkoAuthAws.h>
#import <CkoXml.h>

BOOL success = NO;

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

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

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

// Connect to an SSH server and establish the SSH tunnel:
success = [tunnel SshOpenTunnel: sshHostname sshPort: [NSNumber numberWithInt: sshPort]];
if (success == NO) {
    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 SshAuthenticatePw: @"mySshLogin" sshPassword: @"mySshPassword"];
if (success == NO) {
    NSLog(@"%@",tunnel.LastErrorText);
    return;
}

//  OK, the SSH tunnel is setup.  Now open a channel within the tunnel.
//  (Any number of channels may be created from the same SSH tunnel.
//  Multiple channels may coexist at the same time.)

// This example connects to a REST server through the SSH tunnel.
// It will connect to the Amazon AWS service for this example.
CkoRest *rest = [[CkoRest alloc] init];

BOOL bTls = YES;
int port = 443;
int maxWaitMs = 5000;

// This returns a socket object that is a single channel within the SSH tunnel.
CkoSocket *channel = [[CkoSocket alloc] init];
success = [tunnel SshNewChannel: @"s3.amazonaws.com" port: [NSNumber numberWithInt: port] ssl: bTls maxWaitMs: [NSNumber numberWithInt: maxWaitMs] channel: channel];
if (success == NO) {
    NSLog(@"%@",tunnel.LastErrorText);
    return;
}

// Use the connection.  (This connection is a TLS running on an SSH channel through an SSH tunnel.
// In other words, TLS is wrapped within the SSH tunnel.)
success = [rest UseConnection: channel autoReconnect: YES];
if (success != YES) {
    NSLog(@"%@",rest.LastErrorText);
    return;
}

// Provide AWS credentials for the REST call.
CkoAuthAws *authAws = [[CkoAuthAws alloc] init];
authAws.AccessKey = @"AWS_ACCESS_KEY";
authAws.SecretKey = @"AWS_SECRET_KEY";
authAws.ServiceName = @"s3";
success = [rest SetAuthAws: authAws];

// List all buckets for the account...
NSString *responseXml = [rest FullRequestNoBody: @"GET" uriPath: @"/"];
if (rest.LastMethodSuccess != YES) {
    NSLog(@"%@",rest.LastErrorText);
    return;
}

CkoXml *xml = [[CkoXml alloc] init];
success = [xml LoadXml: responseXml];

// Show the full XML returned.
NSLog(@"%@",[xml GetXml]);

// Iterate over the buckets, showing each bucket name.
success = [xml FindChild2: @"Buckets"];
if ([xml FirstChild2] == YES) {
    NSLog(@"%@",[xml GetChildContent: @"Name"]);
    while (([xml NextSibling2] == YES)) {
        NSLog(@"%@",[xml GetChildContent: @"Name"]);
    }

}

// Move the internal pointer back to the root node.
[xml GetRoot2];