StreamHTTPSParms interface

Represents HTTPS stream parameters that define how to communicate with a MobiLink server using secure HTTPS.

Syntax

public interface StreamHTTPSParms

Members

All members of StreamHTTPSParms interface, including all inherited members.

Name	Description
getCertificateCompany method	Returns the certificate company name for verification of secure connections.
getCertificateName method	Returns the certificate common name for verification of secure connections.
getCertificateUnit method	Returns the certificate unit name for verification of secure connections.
getHost method	Returns the host name of the MobiLink server.
getOutputBufferSize method	Returns the size, in bytes, of the output buffer used to store data before it is sent to the MobiLink server.
getPort method	Returns the port number used to connect to the MobiLink server.
getTrustedCertificates method	Returns the name of the file containing a list of trusted root certificates used for secure synchronization.
getURLSuffix method	Returns the URL suffix of the MobiLink server.
setCertificateCompany method	Sets the certificate company name for verification of secure connections.
setCertificateName method	Sets the certificate common name for verification of secure connections.
setCertificateUnit method	Sets the certificate unit name for verification of secure connections.
setHost method	Sets the host name of the MobiLink server.
setOutputBufferSize method	Sets the size, in bytes, of the output buffer used to store data before it is sent to the MobiLink server.
setPort method	Sets the port number used to connect to the MobiLink server.
setTrustedCertificates method	Sets a file containing a list of trusted root certificates used for secure synchronization.
setURLSuffix method	Sets the URL suffix of the MobiLink server.

The following example sets the stream parameters to communicate with a MobiLink server on host name "MyMLHost". The server started with the following parameters: "-xo https(port=1234;certificate=RSAServer.crt;certificate_password=x)"

SyncParms syncParms = myConnection.createSyncParms(
        SyncParms.HTTPS_STREAM,
        "MyUniqueMLUserID",
        "MyMLScriptVersion"
    );
StreamHTTPSParms httpsParms =
    (StreamHTTPSParms) syncParms.getStreamParms();
httpsParms.setHost("MyMLHost");
httpsParms.setPort(1234);

The above example assumes that the certificate in RSAServer.crt is chained to a trusted root certificate already installed on the client host or device.

For Java SE, you can deploy the required trusted root certificate by using one of the following methods:

1. Install the trusted root certificate in the lib/security/cacerts key store of the JRE.

2. Build your own key store using the Java keytool utility and setting the Java system property javax.net.ssl.trustStore to its location (set javax.net.ssl.trustStorePassword to an appropriate value).

3. Using the setTrustedCertificates(String) parameter to point to the deployed certificate file.

To enhance security, the setCertificateName, setCertificateCompany setCertificateUnit methods should be used to turn on validation of the MobiLink server certificate.

Instances implementing this interface are returned by the SyncParms.getStreamParms method when the SyncParms object is created for HTTPS synchronization.