Modifying Context Root Discovery URLs

The information documents, by default, describe the paths to the different applications’ context roots through the same router port and scheme as the current request is using (by utilizing the host header of the request). This may not be desirable in all cases. For example, you may want to present different context root discovery URLs when traffic from external sources is to be routed through a web server fronting the grid and traffic from internal sources should connect directly to the grid. Another example where you may want a different context root discovery URL is when an application should be defaulted to https even though the discovery-request is not.

To modify the context root discovery URLs, you add or modify entries for the Context root discovery urls grid property. This property is a map where the key is a contextRoot (optionally together with a router) and the value is a list of addresses (optionally together with SSL authentication mode). Multiple entries in the list are a preferred order that enables fallback addresses in the discovery document.

The format for entries in the Context root discovery urls grid property is as follows:

• Key: [RouterName:]contextRootName

• Value (list of): [sslMode:]httpAddress

  Valid sslMode values are:

  • none - applicable for HTTP only

  • server - default for https, the server presents certificates to identify itself to the client

  • client - the server presents certificates to identify itself to the client and the client may choose to identify itself with a certificate

  • required - the server presents certificates to identify itself to the client and the client is required to identify itself with a certificate

To modify or override context root discovery URLs

1. Navigate to the Configuration Manager.

2. Click the Grid Properties link.

3. Locate the property named Context root discovery urls in the Grid Http Discovery Services section.

4. Click the link in the Value column.

5. In the resulting dialog box, click Add New Entry and add values for the context root (and optional router) and for the addresses (and optional SSL authentication modes).

6. Click Save to close the dialog box, click the Save button on the Grid Properties page, and then click Save to confirm the changes.