Appendix H Working with Firewalls or Proxy Servers

This chapter describes how Waveset uses Uniform Resource Locators (URLs) and how to configure Waveset to obtain accurate URL data when firewalls or proxy servers are in place.

Servlet APIs

The Web-based Waveset user interface is highly dependent on Uniform Resource Locators (URLs) to specify the location of pages to be retrieved by the Web client.

Waveset depends on the Servlet APIs provided by an application server (such as Apache Tomcat, IBM WebSphere, or BEA WebLogic) to determine the fully qualified URL in the current HTTP request so that a valid URL can be placed in the generated HTML and HTTP response.

Some configurations prevent the application server from determining the URL the Web client uses for an HTTP request. Examples include:

• A port-forwarding or Network Address Translation (NAT) firewall placed between the Web client and Web server, or between the Web server and application server

• A proxy server (such as Tivoli Policy Director WebSEAL) placed between the Web client and Web server, or between the Web server and application server

For instances in which the Servlet APIs do not provide accurate URL data from an HTTP request, the correct data can be configured in the Waveset.properties file (located in your Waveset installation config directory).

The following attributes control Waveset’s Web-based documentation root and whether Waveset uses the HTML BASE HREF tag:

• ui.web.useBaseHref (Default value: true)— Set this attribute to one of the following values:

• true— Waveset uses the HTML BASE HREF tag to indicate the root of all relative URL paths

• false— All URLs placed into HTML contain fully qualified paths; including scheme, host, and port

• ui.web.baseHrefURL— Set this attribute to a non-empty value to define the BASE HREF used in generated HTML, which overrides the value that is calculated using servlet APIs.

Overriding this calculated value can be useful when those APIs do not return the whole truth, which occurs when:

• The application server is behind a firewall using port forwarding or NAT

• The connector between the application server and Web server does not provide accurate information

• The application server is front-ended by a proxy server