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;
}