The Sessioning session agent uses a single REQ buffer field and applies the MD5 hashing algorithm. MD5 takes a single field of arbitrary size and creates a 32-byte hex-ASCII string, similar to the 32-byte REQ buffer TLTSID value.
MD5 Hashing Method
Configuration for MD5 consists of the following parameters:
Note: MD5
hash is limited to only one sessioning parameter.
PrimarySessMD5=True(optional)PrimarySessField=JSESSIOND(required)PrimarySessFieldMaskOFF=0 35(optional)PrimaryCaseInsensitive=true(optional)
Configuration Settings
The following configuration settings are available for this session agent:
- Display Name values are displayed in TMS, which is the recommended method for configuring session agents.
- Name values are displayed in
TealeafCaptureSocket.cfg.
| Display Name | Name | Description |
|---|---|---|
Sessioning Field |
PrimarySessField |
Specifies the primary REQ field to sessionize. This value can be any field in
the REQ buffer, [urlfield] name/value pair, or REMOTE_ADDR in the
[env] section.You can specify multiple primary session fields. |
Field Offsets |
PrimarySessFieldMaskOff |
Allows for specifying the SessField to be some "substring" of the REQ field.
This is a simple specification of the character start and end offsets. Normally these are integer
values, but the use of the meta-parameter end is also allowed. Offsets are 0-based
values. The following are examples:
|
Section |
PrimarySessFieldSection |
Optional field that indicates which section of the REQ buffer the PrimarySessField is found. By default, the entire request is searched for the field specified by PrimarySessField. |
Case Insensitive |
PrimaryCaseInsensitive |
When set to true, the sessioning parameter may have mixed-case
values.
|
Alternate sessioning fields
This capability allows multiple field names to be specified for PrimarySessField as a
comma-delimited list. Each field name may optionally be prefixed with a section name (e.g.,
cookies:sessionid).
The following is an example:
PrimarySessField=SESSIONID,SESSIONID2,cookies:OTHER_SESSIONID
Note:
- If PrimarySessFieldSection is specified, then it applies to all fields that don't have an explicit section name.
- The PrimarySessFieldMaskOff and PrimaryCaseInsensitive values apply to all sessioning fields.
- SASessioning looks for the sessioning field(s) in the order listed.