Objective-C

Client Certificate in REST

See more REST Examples

Demonstrates how to use a client certificate with a REST connection. Objective-C

#import <CkoRest.h>
#import <CkoSocket.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.

// This example shows how to use the Chilkat socket object's connection.
CkoRest *rest = [[CkoRest alloc] init];
CkoSocket *socket = [[CkoSocket alloc] init];

// Set the certificate to be used for mutual TLS authentication
// (i.e. sets the client-side certificate for two-way TLS authentication)
// Note: There are other ways to set the client certificate using Chilkat.
// For example, on Windows systems, a Chilkat certificate object could be loaded with certificate
// pre-installed (with private key) in a Windows certificate store, and then socket.SetSslClientCert could be called.
success = [socket SetSslClientCertPfx: @"/home/bob/pfxFiles/myClientSideCertWithPrivateKey.pfx" pfxPassword: @"pfxPassword"];
if (success != YES) {
    NSLog(@"%@",socket.LastErrorText);
    return;
}

// Note: The certificate used for the client-side of TLS mutual authentication
// must have the associated private key available. (.pfx/.p12 files typically store both
// the certificate and associated private key.)

// Establish the connection using the socket object (with client certificate authentication).
BOOL bTls = YES;
int port = 443;
int maxWaitMs = 5000;
success = [socket Connect: @"www.example.com" port: [NSNumber numberWithInt: port] ssl: bTls maxWaitMs: [NSNumber numberWithInt: maxWaitMs]];
if (success != YES) {
    NSLog(@"%@%d",@"Connect Failure Error Code: ",[socket.ConnectFailReason intValue]);
    NSLog(@"%@",socket.LastErrorText);
    return;
}

BOOL bAutoReconnect = YES;

// Use the connection:
success = [rest UseConnection: socket autoReconnect: bAutoReconnect];
if (success != YES) {
    NSLog(@"%@",rest.LastErrorText);
    return;
}

// At this point we are connected and can make REST calls...
// For example..
NSString *responseJson = [rest FullRequestNoBody: @"GET" uriPath: @"/someQuery"];
if (rest.LastMethodSuccess != YES) {
    NSLog(@"%@",rest.LastErrorText);
    return;
}