UltraLite Database User's Guide
   Synchronization for UltraLite Applications
    Synchronization parameters reference

Security Parameters synchronization parameter

Function 

Sets the parameters required when using transport-layer security. This parameter must be used together with the security parameter.

For more information, see Security synchronization parameter.

This parameter is not required in static Java applications. To use secure synchronization from UltraLite static Java applications, choose a separate stream. For more information, see UlSecureRSASocketStream synchronization parameters and UlSecureSocketStream synchronization parameters.

Usage 

The ULSecureCerticomTLSStream() and ULSecureRSATLSStream() security parameters take a string composed of the following optional parameters, supplied in an semicolon-separated string.

• certificate_company    The UltraLite application only accepts server certificates when the organization field on the certificate matches this value. By default, this field is not checked.

• certificate_unit    The UltraLite application only accepts server certificates when the organization unit field on the certificate matches this value. By default, this field is not checked.

• certificate_name    The UltraLite application only accepts server certificates when the common name field on the certificate matches this value. By default, this field is not checked.

For example:

ul_synch_info info;
...
info.stream = ULSocketStream();
info.security = ULSecureCerticomTLSStream();
info.security_parms =
     UL_TEXT( "certificate_company=Sybase" )
     UL_TEXT( ";" )
     UL_TEXT( "certificate_unit=Sales" );

The security_parms parameter is a string, and by default is null.

If you use secure synchronization, you must also use the -r command-line option on the UltraLite generator. For more information, see The UltraLite generator.

Interfaces 

• Embedded SQL    See security_parms synchronization parameter.

• Static C++ API    See security_parms synchronization parameter.

• Static Java API    Use a separate synchronization sream.