http listener
Name | Dynamic | Other provider points |
---|---|---|
org.wildfly.undertow.listener | true | none |
Attribute | Value |
---|---|
Default Value | false |
Type | BOOLEAN |
Nillable | true |
Expressions Allowed | true |
Storage | configuration |
Access Type | read-write |
Restart Required | no-services |
Attribute | Value |
---|---|
Default Value | true |
Type | BOOLEAN |
Nillable | true |
Expressions Allowed | true |
Storage | configuration |
Access Type | read-write |
Restart Required | no-services |
Attribute | Value |
---|---|
Default Value | false |
Type | BOOLEAN |
Nillable | true |
Expressions Allowed | true |
Storage | configuration |
Access Type | read-write |
Restart Required | no-services |
Attribute | Value |
---|---|
Default Value | default |
Capability reference | org.wildfly.io.buffer-pool |
Type | STRING |
Nillable | true |
Expressions Allowed | false |
Storage | configuration |
Access Type | read-write |
Restart Required | all-services |
Attribute | Value |
---|---|
Type | LONG |
Nillable | false |
Expressions Allowed | false |
Storage | runtime |
Access Type | metric |
Attribute | Value |
---|---|
Type | LONG |
Nillable | false |
Expressions Allowed | false |
Storage | runtime |
Access Type | metric |
Attribute | Value |
---|---|
Default Value | false |
Type | BOOLEAN |
Nillable | true |
Expressions Allowed | true |
Storage | configuration |
Access Type | read-write |
Restart Required | resource-services |
Attribute | Value |
---|---|
Default Value | true |
Type | BOOLEAN |
Nillable | true |
Expressions Allowed | true |
Storage | configuration |
Access Type | read-write |
Restart Required | no-services |
Attribute | Value |
---|---|
Default Value | ["TRACE"] |
Type | LIST |
Nillable | true |
Expressions Allowed | true |
Storage | configuration |
Access Type | read-write |
Restart Required | resource-services |
Attribute | Value |
---|---|
Default Value | false |
Type | BOOLEAN |
Nillable | true |
Expressions Allowed | true |
Storage | configuration |
Access Type | read-write |
Restart Required | all-services |
Attribute | Value |
---|---|
Default Value | true |
Type | BOOLEAN |
Nillable | true |
Expressions Allowed | true |
Storage | configuration |
Access Type | read-write |
Restart Required | all-services |
Attribute | Value |
---|---|
Type | LONG |
Nillable | false |
Expressions Allowed | false |
Storage | runtime |
Access Type | metric |
Attribute | Value |
---|---|
Default Value | true |
Type | BOOLEAN |
Nillable | true |
Expressions Allowed | true |
Storage | configuration |
Access Type | read-write |
Restart Required | all-services |
Attribute | Value |
---|---|
Type | INT |
Nillable | true |
Expressions Allowed | true |
Unit | BYTES |
Storage | configuration |
Access Type | read-write |
Restart Required | all-services |
Attribute | Value |
---|---|
Type | INT |
Nillable | true |
Expressions Allowed | true |
Unit | BYTES |
Storage | configuration |
Access Type | read-write |
Restart Required | all-services |
Attribute | Value |
---|---|
Type | INT |
Nillable | true |
Expressions Allowed | true |
Storage | configuration |
Access Type | read-write |
Restart Required | all-services |
Attribute | Value |
---|---|
Type | INT |
Nillable | true |
Expressions Allowed | true |
Unit | BYTES |
Storage | configuration |
Access Type | read-write |
Restart Required | all-services |
Attribute | Value |
---|---|
Type | INT |
Nillable | true |
Expressions Allowed | true |
Unit | BYTES |
Storage | configuration |
Access Type | read-write |
Restart Required | all-services |
Attribute | Value |
---|---|
Default Value | 16384 |
Type | INT |
Nillable | true |
Expressions Allowed | true |
Storage | configuration |
Access Type | read-write |
Restart Required | no-services |
Attribute | Value |
---|---|
Type | INT |
Nillable | true |
Expressions Allowed | true |
Storage | configuration |
Access Type | read-write |
Restart Required | no-services |
Attribute | Value |
---|---|
Default Value | 1048576 |
Type | INT |
Nillable | true |
Expressions Allowed | true |
Storage | configuration |
Access Type | read-write |
Restart Required | no-services |
Attribute | Value |
---|---|
Default Value | 200 |
Type | INT |
Nillable | true |
Expressions Allowed | true |
Storage | configuration |
Access Type | read-write |
Restart Required | no-services |
Attribute | Value |
---|---|
Default Value | 1000 |
Type | INT |
Nillable | true |
Expressions Allowed | true |
Storage | configuration |
Access Type | read-write |
Restart Required | no-services |
Attribute | Value |
---|---|
Default Value | 10485760 |
Type | LONG |
Nillable | true |
Expressions Allowed | true |
Storage | configuration |
Access Type | read-write |
Restart Required | no-services |
Attribute | Value |
---|---|
Type | LONG |
Nillable | false |
Expressions Allowed | false |
Storage | runtime |
Access Type | metric |
Attribute | Value |
---|---|
Default Value | 60000 |
Type | INT |
Nillable | true |
Expressions Allowed | true |
Unit | MILLISECONDS |
Storage | configuration |
Access Type | read-write |
Restart Required | no-services |
Attribute | Value |
---|---|
Type | LONG |
Nillable | false |
Expressions Allowed | false |
Storage | runtime |
Access Type | metric |
Attribute | Value |
---|---|
Default Value | false |
Type | BOOLEAN |
Nillable | true |
Expressions Allowed | true |
Storage | configuration |
Access Type | read-write |
Restart Required | resource-services |
Attribute | Value |
---|---|
Type | INT |
Nillable | true |
Expressions Allowed | true |
Storage | configuration |
Access Type | read-write |
Restart Required | no-services |
Attribute | Value |
---|---|
Type | INT |
Nillable | true |
Expressions Allowed | true |
Storage | configuration |
Access Type | read-write |
Restart Required | no-services |
Attribute | Value |
---|---|
Default Value | false |
Type | BOOLEAN |
Nillable | true |
Expressions Allowed | true |
Storage | configuration |
Access Type | read-write |
Restart Required | no-services |
Attribute | Value |
---|---|
Type | STRING |
Nillable | true |
Expressions Allowed | false |
Storage | configuration |
Access Type | read-write |
Restart Required | resource-services |
Attribute | Value |
---|---|
Type | LONG |
Nillable | false |
Expressions Allowed | false |
Storage | runtime |
Access Type | metric |
Attribute | Value |
---|---|
Type | INT |
Nillable | true |
Expressions Allowed | true |
Unit | MILLISECONDS |
Storage | configuration |
Access Type | read-write |
Restart Required | no-services |
Attribute | Value |
---|---|
Default Value | false |
Type | BOOLEAN |
Nillable | true |
Expressions Allowed | true |
Storage | configuration |
Access Type | read-write |
Restart Required | resource-services |
Attribute | Value |
---|---|
Default Value | false |
Type | BOOLEAN |
Nillable | true |
Expressions Allowed | true |
Storage | configuration |
Access Type | read-write |
Restart Required | resource-services |
Attribute | Value |
---|---|
Type | INT |
Nillable | true |
Expressions Allowed | true |
Storage | configuration |
Access Type | read-write |
Restart Required | no-services |
Attribute | Value |
---|---|
Capability reference | org.wildfly.network.socket-binding |
Type | STRING |
Nillable | false |
Expressions Allowed | false |
Storage | configuration |
Access Type | read-write |
Restart Required | all-services |
Attribute | Value |
---|---|
Default Value | 10000 |
Type | INT |
Nillable | true |
Expressions Allowed | true |
Storage | configuration |
Access Type | read-write |
Restart Required | no-services |
Attribute | Value |
---|---|
Type | BOOLEAN |
Nillable | true |
Expressions Allowed | true |
Storage | configuration |
Access Type | read-write |
Restart Required | no-services |
Attribute | Value |
---|---|
Default Value | UTF-8 |
Type | STRING |
Nillable | true |
Expressions Allowed | true |
Storage | configuration |
Access Type | read-write |
Restart Required | no-services |
Attribute | Value |
---|---|
Default Value | default |
Capability reference | org.wildfly.io.worker |
Type | STRING |
Nillable | true |
Expressions Allowed | false |
Storage | configuration |
Access Type | read-write |
Restart Required | all-services |
Attribute | Value |
---|---|
Type | INT |
Nillable | true |
Expressions Allowed | true |
Storage | configuration |
Access Type | read-write |
Restart Required | no-services |
Request Parameter | Type | Required | Expressions Allowed | Default value | Description |
---|---|---|---|---|---|
allow-encoded-slash | BOOLEAN | false | true | false | If a request comes in with encoded / characters (i.e. %2F), will these be decoded. |
allow-equals-in-cookie-value | BOOLEAN | false | true | false | If this is true then Undertow will allow non-escaped equals characters in unquoted cookie values. Unquoted cookie values may not contain equals characters. If present the value ends before the equals sign. The remainder of the cookie value will be dropped. |
always-set-keep-alive | BOOLEAN | false | true | true | If this is true then a Connection: keep-alive header will be added to responses, even when it is not strictly required by the specification. |
buffer-pipelined-data | BOOLEAN | false | true | false | If we should buffer pipelined requests. |
buffer-pool | STRING | false | false | default | The listeners buffer pool |
certificate-forwarding | BOOLEAN | false | true | false | If certificate forwarding should be enabled. If this is enabled then the listener will take the certificate from the SSL_CLIENT_CERT attribute. This should only be enabled if behind a proxy, and the proxy is configured to always set these headers. |
decode-url | BOOLEAN | false | true | true | If this is true then the parser will decode the URL and query parameters using the selected character encoding (UTF-8 by default). If this is false they will not be decoded. This will allow a later handler to decode them into whatever charset is desired. |
disallowed-methods | LIST | false | true | ["TRACE"] | A comma separated list of HTTP methods that are not allowed |
enable-http2 | BOOLEAN | false | true | false | Enables HTTP2 support for this listener |
enabled | BOOLEAN | false | true | true | If the listener is enabled |
http2-enable-push | BOOLEAN | false | true | true | If server push is enabled for this connection |
http2-header-table-size | INT | false | true | The size of the header table used for HPACK compression, in bytes. This amount of memory will be allocated per connection for compression. Larger values use more memory but may give better compression. | |
http2-initial-window-size | INT | false | true | The flow control window size that controls how quickly the client can send data to the server | |
http2-max-concurrent-streams | INT | false | true | The maximum number of HTTP/2 streams that can be active at any time on a single connection | |
http2-max-frame-size | INT | false | true | The max HTTP/2 frame size | |
http2-max-header-list-size | INT | false | true | The maximum size of request headers the server is prepared to accept | |
max-buffered-request-size | INT | false | true | 16384 | Maximum size of a buffered request, in bytes. Requests are not usually buffered, the most common case is when performing SSL renegotiation for a POST request, and the post data must be fully buffered in order to perform the renegotiation. |
max-connections | INT | false | true | The maximum number of concurrent connections. Only values greater than 0 are allowed. For unlimited connections simply undefine this attribute value. | |
max-cookies | INT | false | true | 200 | The maximum number of cookies that will be parsed. This is used to protect against hash vulnerabilities. |
max-header-size | INT | false | true | 1048576 | The maximum size of a http request header, in bytes. |
max-headers | INT | false | true | 200 | The maximum number of headers that will be parsed. This is used to protect against hash vulnerabilities. |
max-parameters | INT | false | true | 1000 | The maximum number of parameters that will be parsed. This is used to protect against hash vulnerabilities. This applies to both query parameters, and to POST data, but is not cumulative (i.e. you can potentially have max parameters * 2 total parameters). |
max-post-size | LONG | false | true | 10485760 | The maximum size of a post that will be accepted, in bytes. |
no-request-timeout | INT | false | true | 60000 | The length of time in milliseconds that the connection can be idle before it is closed by the container, defaults to 60000 (one minute) |
proxy-address-forwarding | BOOLEAN | false | true | false | enables x-forwarded-host and similar headers and set a remote ip address and hostname |
read-timeout | INT | false | true | Configure a read timeout for a socket, in milliseconds. If the given amount of time elapses without a successful read taking place, the socket's next read will throw a {@link ReadTimeoutException}. | |
receive-buffer | INT | false | true | The receive buffer size, in bytes. | |
record-request-start-time | BOOLEAN | false | true | false | If this is true then Undertow will record the request start time, to allow for request time to be logged. This has a small but measurable performance impact |
redirect-socket | STRING | false | false | If this listener is supporting non-SSL requests, and a request is received for which a matching | |
request-parse-timeout | INT | false | true | The maximum amount of time (in milliseconds) that can be spent parsing the request | |
resolve-peer-address | BOOLEAN | false | true | false | Enables host dns lookup |
secure | BOOLEAN | false | true | false | If this is true then requests that originate from this listener are marked as secure, even if the request is not using HTTPS. |
send-buffer | INT | false | true | The send buffer size, in bytes. | |
socket-binding | STRING | true | false | The listener socket binding | |
tcp-backlog | INT | false | true | 10000 | Configure a server with the specified backlog. |
tcp-keep-alive | BOOLEAN | false | true | Configure a channel to send TCP keep-alive messages in an implementation-dependent manner. | |
url-charset | STRING | false | true | UTF-8 | URL charset |
worker | STRING | false | false | default | The listeners XNIO worker |
write-timeout | INT | false | true | Configure a write timeout for a socket, in milliseconds. If the given amount of time elapses without a successful write taking place, the socket's next write will throw a {@link WriteTimeoutException}. |