The proxy-config.xml file

The proxy-config.xml file

The AJAX Proxy configuration is specified 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 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 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 Define one or several IP filtering rules. We can use IP filtering rules to either grant or deny access to a particular IP address or to has a set of addresses. For more details about IP filtering rules, refer to the topic about IP filtering.
meta-data 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 available in the portal, refer to the section about general configuration parameters. When we 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.

After updating the file with the appropriate settings for the environment, restart the portal server.

Access policies
Context path mappings
IP filtering
General configuration parameters
Examples of AJAX proxy configurations

Parent: AJAX proxy configuration
Related reference:
General configuration parameters

policy	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	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	Define one or several IP filtering rules. We can use IP filtering rules to either grant or deny access to a particular IP address or to has a set of addresses. For more details about IP filtering rules, refer to the topic about IP filtering.
meta-data	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 available in the portal, refer to the section about general configuration parameters. When we 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.