Configuring a Sametime server to operate with a reverse proxy server

Use the IBM® Sametime® Administration Tool (hosted on the Sametime server) to configure a Sametime server to operate with a reverse proxy server.

About this task

There are two settings the administrator must configure in the Configuration-Connectivity-Networks and Ports tab of the Sametime Administration Tool to enable a Sametime server to operate with a reverse proxy server. These settings include:

  • Enable Reverse Proxy Discovery on the client - Selecting this setting allows the administrator to enable or disable the reverse proxy support. This setting enables the logic in the Sametime clients that enables them to connect to a Sametime server through the reverse proxy server. This setting is disabled by default.
    Note: Enabling this setting does not require that all users on your corporate intranet access the Sametime server through the reverse proxy server. Users on your corporate intranet that are not required to route Connections through the reverse proxy servers can still establish connections with the Sametime server using the standard Sametime client connection processes. For more information, see Connecting to a Sametime server without going through the reverse proxy server.
  • Server Alias - The Server Alias setting must specify the affinity-id that the administrator uses to represent this Sametime server in the mapping rules on the reverse proxy server.
    Note: The term "Server Alias" is synonymous with affinity-id.

    For example, if the administrator uses the text string "st01" as the affinity-id that represents the Sametime server in the mapping rules on the reverse proxy server, the administrator must also enter "st01" as the value for the Server Alias setting in the Sametime Administration Tool.

    Following a Sametime server installation, the Server Alias setting defaults to the Sametime server name that is extracted from the fully-qualified DNS name of the Sametime server. For example, if the fully-qualified DNS name of the Sametime server is "sametime.ibm.com," the default value for the Server Alias is "sametime."

    Note: An administrator may want to change the default Server Alias setting to avoid using the real Sametime server name as the affinity-id in the mapping rules on the reverse proxy server. If the real Sametime server name is used as the affinity-id on the reverse proxy server, the real server name will appear in URLs transmitted on the Internet.

    For more information about the affinity-id, see Configuring mapping rules on a reverse proxy server to support Sametime.

To enable reverse proxy support on a Sametime server:

Procedure

  1. Open the Sametime Administration Tool.
  2. Click Configuration.
  3. Click Connectivity.
  4. If necessary, click Networks and Ports.
  5. At the end of the Networks and Ports tab, click Enable Reverse Proxy Discovery on the client.
  6. In the Server Alias text box, type the text string that is used as the affinity-id that represents this Sametime server in the mapping configurations on the reverse proxy server (for example, type st01).
  7. Click Update.
  8. Restart the Sametime Commnuity Server for the changes to take effect.