Sun Java System Portal Server 7.1 Deployment Planning Guide

Rewriter

Rewriter is an independent component that translates all URIs (in both HTML and JavaScript code) to ensure that the intranet content is always fetched through the Gateway. You define a ruleset (a collection of rules) that identifies all URLs that need to be rewritten in a page. The ruleset is an XML fragment that is written according to a Document Type Definition (DTD). Using the generic ruleset that ships with the Rewriter, you can rewrite most URLs (but not all) without any additional rules. You can also associate rulesets with domains for domain-based translations.

An external ruleset identifies the URI in the content. Any request that needs to be served by Secure Remote Access follows this route:

ProcedureTo Route Secure Remote Access Requests

  1. From the request, Secure Remote Access identifies the URI of the intranet page or Internet page that needs to be served.

  2. Secure Remote Access uses the proxy settings to connect to the identified URI.

  3. The domain of the URI is used to identify the ruleset to be used to rewrite this content.

  4. After fetching the content and ruleset, Secure Remote Access inputs these to the Rewriter where identified URIs are translated.

  5. The original URI is replaced with the rewritten URI.

  6. This process is repeated until the end of the document is reached.

  7. The resultant Rewriter output is routed to the browser.