Readme for WBI Adapter for HTTP, version 1.2.1.2IF

The patch note contains the following sections:

CONNECTOR REVISIONS

UPGRADE INSTRUCTIONS

CONNECTOR REVISIONS

This patch contains the following revisions since the last maintenance release:

Available as of Version

CR Number/APAR#

Feature

Description

1.2.1.2IF

CR72329/JR22039

HTTP(S) listeners fail redirected requests.

Problem background:

According to HTTP 1.1 specifications (http://www.w3.org/Protocols/rfc2068/rfc2068), section 5.2, an HTTP(S) listener checks the correctness of host and port information specified in the request with host and port information of the listener itself. If there is a mismatch, the listener will stop processing the request and respond with a 400 (Bad Request) status code.

Issue:

When incoming requests are being routed by an enterprise gateway system in order to hide the end point, the host and port information of the request has to be changed before being sent to the HTTP(S) listener (original request has host and port of the gateway). In some cases, such change is not supported by the gateway or is troublesome to implement in the gateway system.

Solution:

A new HTTP(S) listener property has been introduced to solve the above issue. Please note that using this property to disable the validation of host and port information of the request, puts the HTTP(S) listener out of compliance with HTTP 1.1 specification, section 5.2. Use of the new property should be restricted to the cases when an enterprise gateway system change is undesirable.

To use this feature, add the following property as an HTTP Connector Listener Property:

Property Name

Possible Values

HostInfoValidation

FailRequest - if host/port info of the request does not match the host/port info of the listener, the error message will be logged and request will be failed with 400 (Bad Request) status.

LogError - if host/port info of the request does not match the host/port info of the listener, the error message will be logged and request execution will continue.

Ignore - there will be no validation performed on the host/port info of the request.

Note: If the property does not have a valid value, the HTTP(S) listener will DEFAULT property value to FailRequest

1.2.1.1IF

CR70586/JR21370

In the case of asynchronous requests and inactive state, HTTP Adapter does not return error status to the client.

Fixed.

UPGRADE INSTRUCTIONS

Add, replace, or remove the following files and directories as indicated below:


For Connector Version	Platform	Add / Replace / Remove	File (Starting from %CROSSWORLDS%/$CROSSWORLDS)
1.2.1.2IF	WIN & UNIX	Replace the file	%CROSSWORLDS%\connectors\HTTP\BIA_HTTP.jar
1.2.1.1IF	WIN & UNIX	Replace the file	%CROSSWORLDS%\connectors\HTTP\BIA_HTTP.jar

July 5^th, 2005 2:28 PM