Description of the outbound HTTP connection configuration script
The configuration settings of an outbound HTTP connection configuration script are described here.
-
proxy-rules
The
proxy-rules
setting is the root of a configuration profile. The configuration profile for which the script is applied is specified in the configuration task that is run against this script. Theproxy-rules
setting can contain the following subsettings:-
variables
Use the
variables
setting to specify endpoint variables or dynamic policy variables. Variables are used in the URL attribute of the policy setting, or they are used in a variable value. For more details about how to use variables, read Variables. -
mapping
Use the
mapping
setting to map incoming requests to a target URL, based on their context path. Therefore, each mapping must specify acontextpath
attribute and optionally aurl
attribute. Optionally, mappings can declare policy settings that represent mapping specific access policies. For more details about how to use mappings, read Context path mappings. Mappings contain a name attribute that gives an administrative name for this mapping. This attribute is used by administrative tasks to identify the mapping for update tasks or delete tasks. -
policy
Use the
policy
setting 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, the portal denies all incoming requests. For more details about policies, read Access policies. -
ipfilter
Use
ipfilter
setting to define one or more IP patterns. You can use these IP filter patterns to either grant or deny a particular IP address or a set of addresses access to the Ajax proxy. For more details about IP filtering rules, read IP filtering. -
meta-data
Use the
meta-data
setting to specify general configuration properties of the proxy, for example HTTP-related parameters. Eachmeta-data
setting must have aname
and avalue
. To get a list of configuration parameters that are available in the portal, read General configuration parameters by metadata.
-
-
Variables
Variables settings define variables that are used in other sections of the configuration. - Context path mapping
You use a context path mapping to map a specific context path to a specific target URL. The proxy resolves context path mappings before it applies the matching access policy. - Policies
Each policy setting defines an access policy for a URL pattern. You specify the pattern by using the url attribute. A url attribute can be either a URL, or the wildcard character, or URL part that ends with the wildcard character "*". The following are examples for url attribute values: http://localhost/index.html *http://www.ibm.com/developerWorks/*. - IP filtering
You can use ipfilter settings to declare IP filtering rules and to either grant or deny a client access to the Ajax proxy. - Configuration metadata for outbound HTTP connections
You can add general proxy configuration parameters to the file proxy-config.xml by using meta-data settings. - Cookie rule
You can use cookie rules to determine how you want the cookie to be handled.