Skip to main content

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

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.

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.
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