EMSecureContainerFactory Protocol Reference

Conforms to NSObject
Declared in EMSecureContainerFactory.h

Overview

Secure Container Factory

– secureStringFromString: required method

Create a secure string object from a String.

- (id<EMSecureString>)secureStringFromString:(NSString *)string

Parameters

string

The string to securely store. The string will be converted to NSUTF8StringEncoding when stored in the ‘secure data’ object. String can’t be null

Return Value

A ‘secure data’ object that securely stores the data.

Exceptions

NSException

When string is nil or if string encoding is not NSUTF8StringEncoding.

Declared In

EMSecureContainerFactory.h

– secureStringFromString:encoding: required method

Create a secure string object from a String using a specific character set.

Warning: This method does not guarantee that the given string and the given encoding is compatible.

- (id<EMSecureString>)secureStringFromString:(NSString *)string encoding:(NSStringEncoding)encoding

Parameters

string

The string to securely store. String can’t be null
encoding

The string will be converted to this encoding when stored in the ‘secure data’ object. It could be any NSStringEncoding, etc.

Return Value

A ‘secure data’ object that securely stores the data.

Exceptions

NSException

When string is nil or if string encoding is not the one provided in encoding.

Declared In

EMSecureContainerFactory.h

– secureStringFromData:wipeSource: required method

Create a secure string object from a NSData.

- (id<EMSecureString>)secureStringFromData:(NSData *)data wipeSource:(BOOL)wipeSource

Parameters

data

Data to securely store.
wipeSource

If ‘true’, then the ‘data’ will be erased if the method returns successfully. Otherwise the input will not be modified.

Return Value

A ‘secure data’ object that securely stores the data.

Declared In

EMSecureContainerFactory.h

– secureByteArrayWithData:wipeSource: required method

Creates the secure byte array object.

- (id<EMSecureByteArray>)secureByteArrayWithData:(NSData *)data wipeSource:(BOOL)wipeSource

Parameters

data

Data to store to the output object.
wipeSource

Pass true to wipe the original data.

Return Value

The secure byte array object.

Declared In

EMSecureContainerFactory.h