Portlet Preferences
Each instance of the web proxy portlet is configured via portlet preferences. The main preferences indicate the content source, how content should be retrieved, and how the result should be processed. Content services, interceptors, and filters may each define additional preferences for their configuration.
A future version of the portlet will have a full-featured administrative interface. In the meantime, major portlet preference values are listed below.
| Name | Description | Valid Values (out of the box) |
|---|---|---|
| location | Location to be proxied by the content service. Depending on the service, may be a URL, classpath resource, etc. | |
| contentService | Key (spring bean name) of the content service. | httpContentServiceImpl classpathResourceContentService |
| preInterceptors | List of keys (spring bean names) of content request interceptors. Interceptors have the opportunity to modify the URL, headers, and credentials used to make a request. | userInfoUrlParameterizingPreInterceptor |
| filters | Ordered list of keys (spring bean names) of document filters. Filters have the opportunity to modify the HTML document received from a content service. | urlRewritingFilter contentClippingFilter |
PreInterceptors
User Info URL Parameterizing PreInterceptor
This filter can dynamically insert values from the UserInfo map into the URL, query string, and form parameters. Any value of the format \{keyName\} will be replaced the value of that key in the UserInfo map, assuming one exists. If no value for the key exists, the string will not be replaced.
Filters
URL Rewriting Filter
The URL rewriting filter is a key component for any document retrieved via the HTTP content service. This filters rewrites any relative URLs to include the target server and can additionally proxy additional resources from the portlet. For example, the portlet may be configured to proxy images, scripts, or target URLs.
Proxying behavior is controlled by the "whitelistRegexes" portlet preference. This preference should represent zero or more regexes describing which URL paths the portlet should proxy beyond the initial HTTP page request.
Content Clipping Filter
This filter requires an addition portlet preference named "clippingSelector".
Gateway Single Sign On
v2 of WebproxyPortlet supports a more modern implementation of Single Signon, where the external system does not share a backing signon repository, such as LDAP or CAS.