The Inflate session agent performs multiple pipeline functions, including the expansion of data compressed by a web server for HTTP transfer. By default, this session agent is always configured as part of every pipeline. For some deployments of the Processing Server, this session agent is included in the default pipeline and is required.
Overview
Since this session agent is typically present and placed before any of the processing session agents, Inflate session agent has been augmented with additional functionality for performance and pipeline simplicity. It can also perform the following functions:
- Unreqcancelled - This functionality can be used to identify false positives in which a request appears to have been canceled by the visitor. Typically, this functionality can be managed by the Passive Capture Device, but it can be a burden on the CPU. When enabled through the Inflate session agent, this options allows for the offloading of this functionality, as the Inflate session agent is already working with the Response buffer.
- Internationalization - To manage localization issues, the Passive Capture Device can insert some buffer variables into the request related to internationalization. If these variables are not present, the Inflate session agent adds them. This feature requires no configuration.
- Deflate - Optionally, the Inflate session agent can be configured to deflate (compress) the HTTP response data, which is useful in pipelines that are configured to forward captured hits across the network to other servers.
- IPv6 Request Data - To support the indexing and searching for IPv6 addresses, the Inflate session agent inserts some request variables for IP addresses in IPv6-compatible format.
Configuration Settings
The following settings are available for the Inflate 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 |
|---|---|---|
Replace Response On Error |
ReplaceResponseOnError |
When set to True, an error encountered while decompressing a response that has a Content-Encoding of gzip or deflate causes the response body to be replaced with valid HTML containing a descriptive error message.
|
UnReqCancelled |
UnReqCancelled |
Request Cancelled hits occur when the CX Passive Capture Application server cannot complete the capture.
Typical reasons for a hit being Request Cancelled is if the PCA server did not receive a web server response for the browser request or if the size of the web server response did not match the size specification in the response header. In some cases, a mismatch in the response size does not indicate an incomplete response. For example, an HTML response contained a trailing When this setting is set to |
Max Inflate Size |
MaxInflateSize |
This setting specifies the maximum response size to which this session agent inflates a deflated or compressed response. This setting is a pipeline safety limit to prevent inflation of very large responses. The default value is 1536 KB. |
Default Encoding |
DefaultEncoding |
When Mode is set to deflate, this value indicates the default encoding scheme to apply to the decompressed text. The default value is iso-8859-1. |
Compression Level |
CompressionLevel |
When Mode is set to deflate, this value indicates the level of compression to use when compressing. Compression levels range from 1 (least) to 9 (most). The default value is 5. |
Mode |
Mode |
This setting defines the operating mode of the session agent.
|
IPv6 Request Data
CX Passive Capture Application supports the capture of IP addresses in IPv4 and IPv6 format. Depending on the detected format, IP addresses are written into an IPv6-compatible format into the following request variables:
IPV6_REMOTE_ADDRIPV6_LOCAL_ADDR
If these variables are not present in the request, the Inflate session agent automatically inserts them.
These request variables are then indexed for search purposes, enabling the searching for IPv4 or IPv6 addresses through a single search field.