We Have Moved
The IBM Application Gateway has a new home - docs.verify.ibm.com/gateway
The documentation on this site will no longer be maintained after v21.02, please update your bookmarks.
Cookies
Description
Specifies the configuration information associated with the processing of cookies from the resource server.
Properties
The following table(s) describe the configuration properties for this component:
| Name | Type | Constraints | Description |
|---|---|---|---|
| junction_cookie | JUNCTION_COOKIE Object |
JUNCTION_COOKIE Object
The reverse proxy can set a "junction cookie" in returned HTML pages indicating which resource server the page was served from. This is useful for resource servers which dynamically generate URLs that may not be aware or capable of generating URLs containing the path which the reverse proxy served them from.
Junction Cookie Positions
| position | Description |
|---|---|
| inhead | The junction cookie is set in a JavaScript block within the tags of the page. This is required for HTML 4.01 compliance. |
| trailer | The junction cookie is set in a JavaScript block that is appended to the end of the HTML page. |
| httpheader | The junction cookie is returned as a standard HTTP cookie in the HTTP response headers. |
Junction Cookie Versions
| version | Description |
|---|---|
| onfocus | The JavaScript block will contain an onfocus event handler to ensure the correct junction cookie is used in a multiple-junction/multiple-browser-window scenario. |
| xhtml10 | The inserted JavaScript block is HTML 4.01 and XHTML 1.0 compliant. |
| Name | Type | Constraints | Description |
|---|---|---|---|
| position | string | Values: inhead,trailer,httpheader | Controls the position in which the <script> block will be inserted. Refer to the Junction Cookie Positions table above for an explanation of these values. |
| version | string | Values: onfocus,xhtml10 | Controls how the cookie is set. This option is only valid for the inhead and trailer positions. Refer to the Junction Cookie Versions table above for an explanation of these values. |
| ensure_unique | boolean | Values: true,false Default:false |
A boolean flag indicating whether or not to insert the resource server path or host to ensure that the cookie is unique. |
| preserve_name | boolean | Values: true,false Default:false |
A boolean flag indicating whether or not to preserve the original cookie name. When set to false, non-domain cookies are renamed AMWEBJCT!<path>. |
Example
resource_servers:
- path: "/example"
...
cookies:
junction_cookie:
position: inhead
version: onfocus
ensure_unique: true
preserve_name: true