The proxy-config.xml file
The AJAX Proxy configuration is specified by using an XML file named proxy-config.xml.
The latest version of the XML schema of this file consists of the following main elements. They must all be children elements of the proxy rules root element. For more details about the XML schema refer to the topic about the XML schema of the proxy-config.xml file at the end of the section about the AJAX proxy.
policyThe policy element is the most important element in the proxy configuration. Use the policy element to define an access policy for a specific URL pattern. A proxy configuration can contain multiple policy definitions. If no policy is specified at all, all incoming requests are denied. For more details about policies, refer to the section about access policies among the links below.
mappingUse the mapping element to map incoming requests to a target URL, based on their context path. Therefore each mapping element needs to specify a contextpath attribute and optionally a url attribute. Mapping elements can optionally declare policy elements that represent mapping specific access policies. For more details about how to use mapping elements refer to the topic about Context path mappings.
ipfilterUse ipfilter elements to define one or several IP filtering rules. You can use IP filtering rules to either grant or deny access to a particular IP address or to a set of addresses. For more details about IP filtering rules, refer to the topic about IP filtering.
meta-dataUse the meta-data to specify general configuration properties of the proxy, for example. HTTP-related parameters. Each meta-data element must have a name subelement and a value subelement. To get a list of configuration parameters that are available in the portal, refer to the section about general configuration parameters.
After you have completed updating the file with the appropriate settings for environment, restart the portal server.
- Access policies
- Context path mappings
- IP filtering
- General configuration parameters
- Examples of AJAX proxy configurations
Parent
AJAX proxy configuration