Objective-C

Use an XML Certificate Vault with IMAP

Demonstrates the Chilkat Imap.UseCertVault method, which associates an XmlCertVault with the Imap object as a source of certificates and private keys for S/MIME operations. The only argument is the vault. Only one vault is associated at a time.

Note: The certificate path is relative to the application's current working directory. Supply the path to your own certificate file.

Background: An XmlCertVault is a portable container that can hold multiple certificates and keys in a single (optionally password-protected) XML file. It is a convenient way to ship the exact set of credentials an application needs without depending on the operating system's certificate stores. Associating a vault makes all of its contents available for S/MIME decryption and signature verification.

Chilkat Objective-C Downloads

Download Chilkat for Objective-C

Objective-C

#import <CkoImap.h>
#import <NSString.h>
#import <CkoXmlCertVault.h>

BOOL success = NO;

//  Demonstrates the Imap.UseCertVault method, which associates an XmlCertVault with the Imap
//  object as a source of certificates and private keys for S/MIME operations.  The only
//  argument is the XmlCertVault.

CkoImap *imap = [[CkoImap alloc] init];

imap.Ssl = YES;
imap.Port = [NSNumber numberWithInt:993];

success = [imap Connect: @"imap.example.com"];
if (success == NO) {
    NSLog(@"%@",imap.LastErrorText);
    return;
}

success = [imap Login: @"user@example.com" password: @"myPassword"];
if (success == NO) {
    NSLog(@"%@",imap.LastErrorText);
    return;
}

//  The PFX password is not hard-coded in source.  Insert code here to obtain it from an
//  interactive prompt, environment variable, or a secrets vault.
NSString *pfxPassword = 0;

//  Build a certificate vault and add a PFX to it.
CkoXmlCertVault *vault = [[CkoXmlCertVault alloc] init];
success = [vault AddPfxFile: @"qa_data/smime.pfx" password: pfxPassword];
if (success == NO) {
    NSLog(@"%@",vault.LastErrorText);
    return;
}

//  Associate the vault with the Imap object.  Only one vault is associated at a time.
success = [imap UseCertVault: vault];
if (success == NO) {
    NSLog(@"%@",imap.LastErrorText);
    return;
}

success = [imap Disconnect];
if (success == NO) {
    NSLog(@"%@",imap.LastErrorText);
    return;
}