(Objective-C) Socket TLS Mutual Authentication (Client-Side Certificate)

This example demonstrates how to provide a client-side certificate, also known as "two-way authentication" or "mutual authentication" for servers that require a client certificate.

Chilkat Objective-C Library Downloads MAC OS X (Cocoa) Libs iOS Libs

#import <CkoSocket.h>

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

CkoSocket *sock = [[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)
BOOL success = [sock SetSslClientCertPfx: @"/home/bob/pfxFiles/myClientSideCertWithPrivateKey.pfx" pfxPassword: @"pfxPassword"];
if (success != YES) {
    NSLog(@"%@",sock.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 = [sock Connect: @"www.example.com" port: [NSNumber numberWithInt: port] ssl: bTls maxWaitMs: [NSNumber numberWithInt: maxWaitMs]];
if (success != YES) {
    NSLog(@"%@%d",@"Connect Failure Error Code: ",[sock.ConnectFailReason intValue]);
    NSLog(@"%@",sock.LastErrorText);
    return;
}

// At this point, the Socket object is connected and authenticated using the client-side cert

// ...
// ..