HTTP (server)
The HTTP plugin receives web traffic of various types.
The plugin includes the following settings:
- Receiver — a combination of the selected agent, interfaces, and MAC addresses that will receive traffic. Table 191 describes these settings.
Table 191 — Receiver settings
| Name | Description | Value |
|---|---|---|
| Agent | Agent that receives traffic. | Select an agent from the agent list |
| Network interface | Agent network interface that receives traffic. | Select an interface from the interface list |
| Network | A selected Network object (see Networks) whose settings are used to receive traffic. If you select more than one object, you can adjust the weight that balances packet distribution among them. | Select a Network object. Set its weight; by default, packets are distributed evenly among the selected objects |
- IP header (L3) — IP header settings at L3 in the TCP/IP stack. Table 192 describes these settings.
Table 192 — IP header (L3) settings
| Name | Description | Value |
|---|---|---|
| TTL (Time to Live) | Maximum number of routers (hops) that a packet can traverse before it is discarded. | Enter a number (default: 128) |
| ToS (Type of Service) | DSCP is an IP header field used to determine traffic priority and handling. | Enter a number (default DSCP: 7) |
| ToS (Type of Service) | ECN allows routers to notify endpoints about network congestion without dropping packets. | Select: 00 (Non-ECT), 01 (ECT(1)), 10 (ECT(0)), or 11 (CE (Congestion Experienced)) |
- TCP header (L4) — TCP header settings at L4 in the TCP/IP stack. Table 193 describes these settings.
Table 193 — TCP header (L4) settings
| Name | Description | Value |
|---|---|---|
| Max. Segment Size | Maximum amount of data that can be carried in one TCP segment. | Enter a number (default: 1460) |
| WS (IP Options) | TCP Window Scale increases the window available for flow control. | Enter a number (default: 64) |
| Window Size | Amount of TCP data that can be sent before an acknowledgment is required. | Enter a number (default: 256) |
- HTTP settings — HTTP header settings at L6–L7 in the TCP/IP stack. Table 194 describes these settings.
Table 194 — HTTP settings
| Name | Description | Value |
|---|---|---|
| HTTPS | Determines whether HTTPS is used for secure data transfer. | Yes / No. Use the toggle. If enabled, configure the TLS settings described in Table 195 |
| HTTP version | HTTP protocol version used for data transfer. | Select HTTP 1.1 or HTTP 2.0 |
| HTTP method | Method used when the agent responds to incoming requests. | Select GET, POST, PUT, PATCH, or DELETE |
| Request body | HTTP request section containing the data the server sends in response to an incoming request, such as a form or JSON. Available for POST, PUT, and PATCH. | Enter a request body. ${str(length)} generates a random character sequence of the specified length, for example ${str(16)}. ${strMinMax(min\_length,max\_length)} generates a random character sequence within the specified length range, for example ${strMinMax(16,24)}. ${hex(length)} generates a hexadecimal character sequence of the specified length, for example ${hex(16)}. ${hexMinMax(min\_length,max\_length)} generates a hexadecimal character sequence within the specified length range, for example ${hexMinMax(16,24)}. ${email} generates a valid email address with a random username and domain. ${login} generates a valid username. ${password} generates a valid password. |
| Headers | Additional metadata sent with the HTTP request. | Click Add parameters, then enter a value. ${str(length)} generates a random character sequence of the specified length, for example ${str(16)}. ${strMinMax(min\_length,max\_length)} generates a random character sequence within the specified length range, for example ${strMinMax(16,24)}. ${hex(length)} generates a random hexadecimal sequence of the specified length, for example ${hex(16)}. ${hexMinMax(min\_length,max\_length)} generates a random hexadecimal sequence within the specified length range, for example ${hexMinMax(16,24)}. ${email} generates a valid email address with a random username and domain. ${login} generates a valid username. ${password} generates a valid password. |
Table 195 — TLS settings
| Name | Description | Value |
|---|---|---|
| TLS version | TLS (Transport Layer Security) protocol version used to secure data transfer between client and server. Available when HTTPS is enabled. | Select TLS v1.2 or TLS v1.3 |
| SSL certificate | Server SSL certificate used to establish the TLS connection. | Select a value |
| SSL ciphers | Cipher suites that the server offers or accepts during the handshake. | Select a value |
- Session settings — settings that control sessions for the current plugin. Table 196 describes these settings.
Table 196 — Session settings
| Name | Description | Value |
|---|---|---|
| Session timeout | Maximum period for which a client-server session remains active and valid without being refreshed or re-established. | Enter a number and select seconds, minutes, or hours |
- Duration — the plugin runtime. Table 197 describes this setting.
Table 197 — Duration setting
| Name | Description | Value |
|---|---|---|
| Traffic reception duration | Period for which the agent receives and responds to incoming traffic. | Enter a number and select seconds, minutes, or hours |