One moment please...
Exact Synergy Enterprise   

How-to: Adding Support for Session ID to Synergy Connectivity Client

What does the code do?

Get the session ID from the web server and forward it to the subsequent WCF request so that the session on the server can be reused. The session ID follows the standard protocol on session handling:

  1. The first WCF request is a normal request that does not contain any session ID.
  2. The web server will send a response with a new session ID in the HTTP response header.
  3. Retrieve the session ID and store it locally.
  4. This session ID will be added to the HTTP request header before sending the next WCF request.

How to use it?

  1. Add the 2 vb files from the attachment to the project.
  2. Declare an instance level variable for WebSessionBehavior.

sessionBehavior As WebSessionBehavior

It is very important that this variable should remain available for use throughout the entire application life cycle because this object is responsible for storing the session ID. If it is destroyed and recreated, then a new session ID will be obtained on the next WCF request, which causes the server to recreate a new session.

  1. Add the behavior after creating the proxy client (as displayed in the following, in bold italic).

Dim ent As New EntityEngine.EntityClient
ent.ClientCredentials.Windows.AllowedImpersonationLevel = System.Security.Principal.TokenImpersonationLevel.Impersonation
ent.Endpoint.Address =
New System.ServiceModel.EndpointAddress("http://localhost/242/services/exact.entity.svc"

  1. The task is complete. The task to handle the session ID will be handled by the two new classes (ClientMessageInspector & WebSessionBehavior).


  • This only works for web services hosted in IIS, such as those from Exact Synergy Enterprise. It does not work with Exact Globe yet.

 Main Category: Support Product Know How  Document Type: Online help main
 Category: On-line help files  Security  level: All - 0
 Sub category: General  Document ID: 19.725.603
 Assortment:  Date: 20-05-2010
 Release:  Attachment:

Attachments 1.3 KB Download