Example of URL mapping configuration on the reverse proxy server

Here are some examples of how an administrator might configure URL mapping configurations for a reverse proxy server deployed in front of an IBM® Sametime® server.

When a user connects to a Sametime server through a reverse proxy server, the reverse proxy server must be configured so that the user can click on links in the Sametime server home page and navigate to the various HTML pages of the user interface. This capability requires the reverse proxy server to rewrite the URLs of the HTML pages that comprise the Sametime UI.

Reverse proxy mapping configurations that enable a web browser user to navigate the Sametime user interface

The following example illustrates how an administrator can configure the reverse proxy server to enable users to navigate the HTML pages of the Sametime user interface. This example assumes the following:

  • The Sametime server name is "sametime.ibm.com."
  • The URL required to access the reverse proxy server is "reverseproxy.ibm.com."
  • The affinity-id chosen by the administrator for the Sametime server is "st01."

The URL for the Sametime server home page on a Sametime server that has the server name sametime.ibm.com is http://sametime.ibm.com/servlet/auth/admin.

Example - Translating the URL of the server home page

To access the Sametime server home page through a reverse proxy server, the web browser would send the following URL to the reverse proxy server:
http[s]://reverseproxy.ibm.com/st01/servlet/auth/admin
The reverse proxy server must contain a mapping rule that translates this URL into the following URL required to access the Sametime server home page:
http[s]://sametime.ibm.com/servlet/auth/admin

A single mapping rule can be used to translate all URLs associated with the Sametime server user interface

Through the use of wildcards, the administrator can create a single mapping rule on the reverse proxy server to translate all URLs associated with the Sametime server interface. For example, the administrator can create a mapping rule that translates the following URL from the web browser:
http[s]://reverseproxy.ibm.com/st01/*
To this Sametime server URL:
http[s]://sametime.ibm.com/*

A single mapping rule that accomplishes this type of URL translation should enable users to access all entities of the Sametime user interface through a reverse proxy server.

Note: It is not mandatory to configure the mapping rules. The actual configuration of the mapping rules on the reverse proxy server is at the discretion of the administrator. When configuring the mapping rules note that the URL for any entity of the Sametime server user interface will begin with the Sametime server name (sametime.ibm.com in this example).