Cookies
resource_servers[]/cookies
Specifies the configuration information associated with the processing of cookies from the resource server.
Properties
Name | Type | Constraints | Description |
---|---|---|---|
junction_cookie | junction_cookie |
resource_servers[]/cookies/junction_cookie
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 <head> </head> 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. |
Properties
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 or false Default value: 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 or false Default value: 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
Updated over 2 years ago