Routing Wizard

Contents

Overview

For convenience, a Routing Wizard is provided to enable administrators to quickly configure the filters necessary to route messages onwards to a specific destination. The wizard will auto-generate the following filters:

Filter Role Help Page
Rewrite URL This filter determines the request URI of the HTTP request that is ultimately made by the Connection filter below. A complete URL should be entered in this field (e.g. http://host:8080/services), from which the host and port will be extracted and used to configure the Static Router below. Rewrite URL
Static Router The Static Router filter specifies the host of the destination server together with the port to connect to on that host. Static Router
Connection The Connection filter is responsible for actually establishing the connection to the URL, host, and port specified in the Rewrite URL and Static Router filters. If an SSL connection is required, it is possible to select a certificate from the Trusted Certificate Store to use to authenticate to the destination server and also what certificates are considered trusted by the Enterprise Gateway so that the destination server's certificate can be trusted. Connection

Configuration

To avail of the Routing Wizard for a particular policy, right-click on the name of the policy in the tree view of the Policy Studio and select the Routing Wizard menu option. Configuring the URL field and/or fields on the Proxy Settings tab of the Routing Wizard dialog will result in the auto-generation of a Rewrite URL filter and also a Static Router filter.

URL:
Enter the full URL of the destination Web Service in this field. The host, port, and scheme (i.e. HTTP or HTTPS) will be extracted from the URL and used to configure a Static Router filter.

Proxy Host:
If, however, you want to send the request via an HTTP proxy, you should configure the Proxy Host and Proxy Port, in which case the Static Router filter be configured with the host and port entered in these fields and the Connection filter will send the complete URL specified in the URL field above as the request URI to the proxy, as required by the HTTP specification. The proxy then knows where to route the message on to.

Note that if the Proxy Host and Proxy Port fields are completed, the wizard will automatically check the Send via proxy field on the Advanced tab of the auto-generated Connection filter.

Proxy Port:
If you want to route messages via a proxy to the destination Web Service, enter the port on the Proxy Host specified above on which the proxy accepts requests.

SSL Port:
If the proxy is SSL-enabled, enter the SSL port in this field.

Trusted Certificates, Client SSL Certificates, and Advanced Tabs
The settings configured on the remaining tabs of the wizard correspond to the settings configured on the tabs that appear on the Connection filter. For more information on configuring the fields on these tabs please refer to the Connection help page.