                Solace Corporation Messaging API for C Sample Programs

SPECIAL INSTRUCTIONS FOR THE SECURESESSION EXAMPLE

The SecureSession iOS example requires certificates to facilitate appliance and 
client certificate validation.

Appliance validation requires that the server certificate be installed on the 
appliance, and that the iOS application have access to a trust store containing 
the root CA certificate. Similarly, client validation requires that the trust 
store containing the root CA certificate be installed on the appliance, and 
that the iOS application have access to the client certificate.

By default, the SecureSession example uses the Basic Authentication Scheme for authentication. 
An empty iOS resource bundle called "certificates.bundle" is created as a placeholder 
for trusted certificates. The resource bundle is used by the SecureSession example as a 
default value for its session property 'SOLCLIENT_SESSION_PROP_SSL_TRUST_STORE_DIR'.
In order to run the example, a trusted certificate must be added to the resource bundle 
folder "trustStores" before building. If added afterwards, you will need to clean the 
project and then build again.

To use the Client Certificate Authentication Scheme, the SecureSession example 
has to be able to access client certificate and client private key file(s) under its
application Documents directory. The client certificate and client private key
file(s)  must first be uploaded to the application Documents directory 
through the iTunes file sharing feature.  The SecureSession example's 
configuration parameters for the client certificate file name and the client 
private key file name must then be updated with a file path relative to the 
Documents directory accordingly.

