Configuring Encryption for Mobile Web Client Synchronization

This topic describes how to enable encryption for Siebel Mobile Web Client synchronization. During this synchronization, DX files are transferred between the Siebel Server and Mobile Web Clients. DX files use messages to transfer information between the Siebel Server and Mobile Web Clients.

This task is a step in Process of Configuring Secure Communications.

The Siebel Mobile Web Client reads configuration parameters in the Siebel application configuration file to determine the type of encryption to use during synchronization. Encryption options are defined as one of the elements in the DockConnString parameter.

Note: TLS is the supported encryption method for the Siebel Developer Web Client and for synchronization of the local database on the Siebel Mobile Web Client.

For information about authentication for Siebel Mobile Web Client and Siebel Remote, see About Authentication for Mobile Web Client Synchronization. For general information on configuring encryption for Web clients, see About Configuring Encryption for Web Clients. For information about other security issues for Siebel Mobile Web Client, including encrypting the local database, see Siebel Remote and Replication Manager Administration Guide.

To configure encryption for Mobile Web Client synchronization

Open the Siebel application configuration file that you want to edit.
Configuration files for a client are stored in the client’s bin\LANGUAGE directory, where LANGUAGE represents an installed language pack, such as ENU for U.S. English.
When synchronization is performed within an application (using File, Synchronize, and then Database), configuration is read from the configuration file associated with the application (siebel.cfg is used for Siebel Sales). For more information about working with Siebel application configuration files, see Siebel System Administration Guide.
Note: You can use any plain text editor to edit configuration files. However, when you edit configuration files, do not use a text editor that adds additional, nontext characters to the file.
Locate the DockConnString parameter in the [LOCAL_SE] section of the configuration file and modify it as required.
Note: As of Siebel CRM 20.8 Update, Oracle Database SE2 has replaced Oracle Database XE for the local database for Siebel Mobile Web Client. For more information, see Siebel Installation Guide.
The DockConnString parameter specifies the name of the Siebel Server used to synchronize with the client and the type of encryption to use during synchronization, and it has the following format:
```
siebel_server_name::sync_port_number:encryption
```
where:
- siebel_server_name is the logical network address of the Siebel Server that the remote client uses to connect and synchronize
- sync_port_number is the TLS or TCP/IP port number that Siebel Remote uses for the Synchronization Manager. If you do not specify any value, then the default value is 40400.
- encryption (optional) is the type of encryption used during synchronization. As of Siebel CRM 19.6 Update, Siebel Remote supports TLS for synchronization, where the necessary configuration has been done on the server and the clients. If you do not specify TLS, then no encryption is used.
Example values for the DockConnString parameter are:
- If using TCP-IP: APPSRV::40400
- If using TLS: APPSRV::40400:TLS
Save your changes and exit the file. For more information about editing configuration files for Siebel Remote and Mobile Web Clients, see Siebel Remote and Replication Manager Administration Guide and Siebel System Administration Guide.
Deploy SHA-2 certificate files on the Siebel Server and remote clients. This is required to use TLS encryption. For more information, see the topic about configuring TLS encryption in Siebel Remote and Replication Manager Administration Guide.