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. The portal
server validates the proxy-config.xml files against
the referenced schema at startup time.
- policy
- The 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.
- mapping
- Use 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.
- ipfilter
- Use 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-data
- Use the meta-data element 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. When you use an XML schema version earlier than Version 1.2, meta-data elements apply only directly under a mapping or a proxy-rules section. Starting with XML schema Version 1.2, selected meta-data elements can also be used within policies. The topic General configuration parameters provides more details on this.