![]() | |
Sun Java System Web Proxy Server User Interface |
The URLs Tab
The URLs tab contains the following pages:
The View/Edit Mappings PageThe View/Edit Mappings page can be used to edit the prefix, the mapped URL, and template that are affected by the mapping.
The following elements are displayed:
Information. Displays all the current mappings.
Edit. Click this link to edit the mapping.
Remove. Click this link to delete this mapping. Click OK to confirm the deletion.
The Create Mapping PageThe Create Mapping page is used to create URL Mappings.
The following elements are displayed:
Mapping Type. Select the type of mapping you want to create.
- Regular. Maps a URL prefix to another URL prefix. For example, you can configure the proxy to go to a specific URL any time it gets a request that begins http://www.example.com. If you select this option, the following option is displayed in the lower section of the page:
- Reverse. Maps a redirected URL prefix to another URL prefix. These are used with reverse proxies when the internal server sends a redirected response instead of the document to the proxy. For more information about reverse proxy see, “Reverse Proxy” in the Proxy Server Administration Guide. If you select this option, the following option is displayed in the lower section of the page:
- Rewrite Location. Click the appropriate option to indicate whether the Location HTTP response header should be rewritten.
- Rewrite Content Location. Click the appropriate option to indicate whether the Content-location HTTP response header should be rewritten.
- Rewrite Headername. Select the check box to indicate whether the headername HTTP response header should be rewritten, where headername is a user-defined header name.
- Regular Expressions. Map all URLs matching the expression to a single URL. For more information on regular expressions, see "Understanding Regular Expressions" in the Proxy Administration Guide.
- Client Autoconfiguration. Maps URLs to a specific .pac file stored on the Proxy Server. For more information on autoconfiguration files, see "Using the Client Autoconfiguration File" in the Proxy Server Administration Guide.
- Proxy Array Table (PAT). Maps URLs to a specific .pat file stored on the Proxy Server. You should only create this type of mapping from a master proxy. For more information on PAT files and proxy arrays, see "Routing through Proxy Arrays" on in the Proxy Server Administration Guide.
Map Source Prefix. Type the URL prefix. For regular and reverse mappings, this should be the part of the URL you want to substitute.
For regular expression mappings, the URL prefix should be a regular expression that for all the URLs you want to match. If you also choose a template for the mapping, the regular expression will work only for the URLs within the template’s regular expression.
For client autoconfiguration mappings and proxy array table mappings, the URL prefix should be the full URL the client accesses.
Map Destination. Type a map destination. For all mapping types except client autoconfiguration and proxy array table, this should be the full URL to which to map. For client autoconfiguration mappings, this value should be the absolute path to the .pac file on the Proxy Server’s hard disk. For proxy array table mappings, this value should be the absolute path to the .pat file on the master proxy’s local disk.
Use This Template. Select the template name from the drop-down list, or leave the value at NONE if you do not want to apply a template.
OK. Saves your entries.
Reset. Erases your changes and resets the elements in the page to the values that they contained before your changes.
Information. Displays all the current mappings.
Edit. Click this link to edit the mapping.
Remove. Click this link to delete this mapping. Click OK to confirm the deletion.
The Configure Virtual Multihosting PageThe Configure Virtual Multihosting page is used to configure virtual multihosting that allows an origin server or a reverse proxy server to respond to multiple DNS aliases as if there was a different server installed in each of those addresses. As an example, you could have the DNS host names:
Each of them could be mapped to the same IP address (the IP address of the reverse proxy). You could then have the reverse proxy act differently based on which DNS name was used to access it.
Virtual Multihosting allows you to host multiple different *domains* in a single reverse proxy server as well. For example:
The following elements are displayed:
Source Hostname (alias). Specify the local host name (or DNS alias) to which this mapping should apply.
Source Domain Name. Enter the local domain name that this mapping should apply to. Typically, this is your own network’s domain name, unless you want to multi-host multiple different DNS domains.
Destination URL Prefix. Enter the target URL prefix where the request will be directed if the host and domain names match the above specifications
Use This Template. Select the template name from the drop-down list, or leave the value at NONE if you do not want to apply a template.
OK. Saves your entries.
Reset. Erases your changes and resets the elements in the page to the values that they contained before your changes.
All virtual multihosting mappings appear on the bottom of the Virtual Multihosting configuration page. Note that the Source Hostname (alias) and Source Domain Name fields are merged, together with the proxy’s port number, into a single regular expression that is used to match the Host header.
For example, if you have host name www, domain name example.com, and port number 8080, the virtual mapping will display the regular expression:
www(|.example.com)(|:8080)
This will guarantee a match with all of the following possible combinations that the user might have typed, or the client might have sent (the port number may be omitted by some client software even when it is non-80, as it is obvious to the server which port number it was listening on):
Information. Displays all the current virtual mappings.
Edit. Click this link to edit the mapping.
Remove. Click this link to delete this mapping. Click OK to confirm the deletion.
The Redirect URLs PageThe Redirect URLs page is used to configure the Proxy Server to return a redirected URL to the client instead of getting and returning the document. With redirection, the client is aware that the URL originally requested has been redirected to a different URL. The client usually requests the redirected URL immediately. Netscape Navigator automatically requests the redirected URL--the user does not have to explicitly request the document a second time.
URL redirection is useful when you want to deny access to an area because you can redirect the user to a URL that explains why access was denied.
The following elements are displayed:
URL Prefix. Enter the URL prefix.
Forward Requests To. If you choose to use a URL prefix as the URL to redirect to, select the radio button next to the URL prefix field and enter a URL prefix. If you choose to use a fixed URL, select the radio button next to the Fixed URL field and enter a fixed URL.
OK. Saves your entries.
Reset. Erases your changes and resets the elements in the page to the values that they contained before your changes.
Current Forwarding. Lists all the URL forwards that have been added.
Edit. Click this link to edit the mapping.
Remove. Click this link to delete this mapping. Click OK to confirm the deletion.