Identity Manager 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.
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 Identity Manager installation config directory).
The following attributes control Identity Manager’s Web-based documentation root and whether Identity Manager uses the HTML BASE HREF tag:
ui.web.useBaseHref (Default value: true)— Set this attribute to one of the following values:
true— Identity Manager 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