Configure access to an external Web service or WSDL file through
a password-protected proxy server.
Why and when to perform this task
Service integration technologies requires access to the Internet
for invoking outbound services and for retrieval of external WSDL files. Many
enterprise installations use a proxy server in support of Internet routing,
and many proxy servers require authentication before they grant access to
the Internet. This requirement is supported in HTTP messaging by a Proxy-Authorization
message header that contains encoded user ID and password credentials.
To
enable service integration technologies to invoke an outbound service you
configure, for each outbound port, a proxy host, port and J2C authentication
alias.
When you create or modify inbound or outbound services, the service
integration bus might also need to pass messages through an authenticating
proxy server to retrieve WSDL documents. Consequently you must configure
the proxy host and port that are used.
Note: Neither the administrative console
panels used to create a new Web service configuration, nor the
Reload
WSDL button provided on the panels used to modify an existing
Web service configuration, allow you to enter an authentication alias for
WSDL retrieval. If the bus needs to pass messages through an authenticating
proxy server to retrieve WSDL documents, then you must
use command-line tools to retrieve the WSDL.
Steps for this task
- Start the WebSphere Application Server administrative server.
- Start the administrative console.
- To enable invocation of an outbound service through a password-protected
proxy server, complete the following steps:
- In the administrative console navigation pane, click bus-name.
- Create a J2C authentication alias, providing
an alias name, and the user ID and password required by the authenticating
proxy server.
- Click OK.
- In the administrative console navigation pane, click bus-nameservice-nameport-name.
- Type into the appropriate fields the authenticating proxy host
name, port, and the authentication alias you created.
- Click OK.
- To enable the service integration bus to pass messages through
an authenticating proxy server to retrieve WSDL documents, complete the following
steps:
- In the administrative console navigation pane, select Application
Servers > server_name > Process Definition > Java Virtual Machine >
Custom Properties.
- Set the following properties:
- http.proxySet - Set this to true to tell the application
server that it is required to work with an authenticating proxy.
- http.proxyHost - Set this to the machine name of the authenticating
proxy.
- http.proxyPort - Set this to the port through which the authenticating
proxy is accessed. For example 8080.
- http.nonProxyHosts - List the internal machines for which authentication
is not required for routing through the proxy. Separate each machine name
in the list with a vertical bar ("|").
- This list must include the machine on which the bus is installed.
- Save your changes to the master configuration.
- Stop then restart the application server.
- Close the administrative console.