Configure HTML Rewrite for SSO

Edit online

About this task

HTML rewriting allows you to replace the URL links returned by an HTTP server to the Secure Proxy server by configuring how the URL links from the server will be mapped to the URL links in Secure Proxy. If the HTTP server has web pages with links to other web pages, you must map the URL connections in order for the links to work. You must configure HTML rewrite in order for the Sterling File Gateway application to function correctly.

Certain pages on the dashboard use javascript to create URL dynamically using a back-end host name literal. To change this host name to the proxy host name, you add another entry to the HTML rewrite. Use the third entry in the table below as an example.

Note: HTML rewrite may not work for arbitrary javascripts that dynamically create URL at the client side.

To configure this environment, use the following table to help you identify the rewrite values to define in the netmap definition:

  • Provide a value for each Secure Proxy feature listed. Fields listed in the worksheet are required.
  • Accept default values for fields not listed.
  • Note the Configuration Manager field where you will specify the value.

Server URL

Proxy URL

http(s)://<fully qualified DNS name for the SFG_host>:<port>

http(s)://<fully qualified DNS name for the proxy_host>:<adapter1_port>

http(s)://<SFG_ipaddress>:<port>

http(s)://<proxy_ipaddress>:<port>

http(s)://<fully qualified DNS name for the SFG_host>

http(s)://<fully qualified DNS name for the proxy_host>

<fully qualified DNS name for the SI_host>

<fully qualified DNS name for the proxy host>

To configure HTML rewrite:

Procedure

  1. From IBM Sterling Secure Proxy, select Configuration from the left hand-side navigation panel.
  2. Click Netmaps, then in the HTTP Netmap tile, click View Netmaps to display the list of created HTTP Netmaps.
  3. Choose the netmap you wish to edit, then click on the Edit icon.
  4. Click the HTML Rewrite Nodes tab.
  5. Click Add HTML Rewrite Node +.
  6. Enable the Support HTML Rewrite field.
  7. Type the URL path for the outbound server in the Server URL field.
  8. Type the URL path for the proxy in the Proxy URL field.
  9. Click Save.
  10. Repeat steps 4 through 8 for all HTML Rewrite options you want to configure.
  11. To reorder the HTML rewrite definitions:
    1. Click the radio button beside the URL routing definition to reorder.
    2. Click Move Up or Move Down until the item is in the correct order.
  12. Click Save.
  13. Test the configuration to ensure that single sign-on and HTML rewrite to the Sterling File Gateway server is configured correctly.