Cookie Parser Session Agent

To enable easy searching, the CookieParser session agent parses cookies appearing after the HTTP_COOKIE value in the request into name-value pairs. Cookie data is placed at the bottom of the request in a section entitled [cookies].

The following is an example:


[cookies]
TLTSID=CF37A9C511D67E7F03003785F87C9647z0
TLTHID=CF37A9C511D67E7F03003785F87C9647
TLTUID=CC50ED7C11D67E1C90003B95BC7A8A27
SITESERVER=ID=3c576155747d32c21e27fa781a689ac7
TLT_NumCookies=4
TLT_CookiesBytes=165

Configuration Settings

The following configuration settings are available:

Display Name values are displayed in TMS, which is the recommended method for configuring session agents.
Name values are displayed in TealeafCaptureSocket.cfg.

Table 1. Cookie Parser Session Agent
REQTEXT
Display Name	Name	Description
`Cookie Delimiter`	`CookieDelimiter`	Delimiter used in Cookies header. The default value is `;`.
`Extract`	`Extract`	Allows for the extraction of sub-values from a cookie value. The default value is `YES`.
`Fragment Delimiter`	`FragmentDelimiter`	Used in conjunction with the Extract option, this setting specifies cookie fragment delimiter. The default value is `.
`URL Decode`	`URLDecode`	Specifies if the cookie value should be URL-decoded. The default value is `YES`.

Cookie Delimiter

The Cookie Parser allows users to denote their own cookie delimiter, which allows a wider range of cookie formats to be processed.

If no delimiter is provided, a semicolon (;) character is used.
If you use more than one character, the cookie parser uses only the first char in the string as the delimiter.
To denote your own delimiter, add the following to the CookieParser section of the configuration file:
```
CookieDelimiter=<somechar>
```

Avoid Using Ampersand as a Delimiter

Avoid using the ampersand (&) character as a delimiter. This character is commonly used to denote fragments within a parent cookie, such as the following:


HTTP_COOKIE=TLTUID=567683546&id=1234&page=0; TLTRUID=234567;

Which would typically result in the following:


TLT_NumCookies=2
TLT_CookiesBytes=48
TLT_NumCookieFragments=2
TLT_CookieFragmentBytes=15

However, using ampersand (&) as the delimiter generates the following:


TLT_NumCookies=3
TLT_CookiesBytes=48
TLT_NumCookieFragments=0
TLT_CookieFragmentBytes=0

Note the incorrect values.

Configuration Settings

Cookie Delimiter

Avoid Using Ampersand as a Delimiter

Join the community

Academy

Session agent reference

Configuration Settings

Cookie Delimiter

Avoid Using Ampersand as a Delimiter

Related articles

Join the community

Academy