WildFly 37 Model Reference

Deprecated Since 1.7.0
The http-interface configuration is deprecated and may be removed or moved in future versions.

Configuration of the server's HTTP management interface

Provided capabilities(2)

Name Dynamic Other provider points
org.wildfly.management.http.extensible false

none
org.wildfly.management.http-interface false

none

Attributes (15)

  • allowed-origins Comma separated list of trusted Origins for sending Cross-Origin Resource Sharing requests on the management API once the user is authenticated.
    • Attribute Value
    Type LIST
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • 🅲 backlog The maximum number of pending connections on the socket.
    • Attribute Value
    Default Value 50
    Type INT
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required resource-services
    Stability community
  • 🅲 connection-high-water The maximum number of connections that can be open at any one time.
    • Attribute Value
    Default Value 100
    Type INT
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required resource-services
    Stability community
  • 🅲 connection-low-water The number of connections that the open count must reduce to before the connection-high-water level is reset.
    • Attribute Value
    Default Value 75
    Type INT
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required resource-services
    Stability community
  • console-enabled Flag that indicates admin console is enabled
    • Attribute Value
    Default Value true
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • constant-headers The set of constant HTTP headers to apply to response messages.
    • Attribute Value
    Type LIST
    Nillable true
    Expressions Allowed false
    Storage configuration
    Access Type read-write
    Restart Required resource-services
    Stability default
  • http-authentication-factory The authentication policy to use to secure the interface for normal HTTP requests.
    • Attribute Value
    Capability reference
    Type STRING
    Nillable true
    Expressions Allowed false
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • http-upgrade HTTP Upgrade specific configuration
    • Attribute Value
    Type OBJECT
    Nillable true
    Expressions Allowed false
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • http-upgrade-enabled Flag that indicates HTTP Upgrade is enabled, which allows HTTP requests to be upgraded to native remoting connections
    • Deprecated Since 5.0.0
    Instead use http-upgrade.enabled
    Attribute Value
    Type BOOLEAN
    Nillable true
    Expressions Allowed false
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • 🅲 no-request-timeout The maximum time in milliseconds a connection can be idle without a HTTP request before it is closed.
    • Attribute Value
    Default Value 60000
    Type INT
    Nillable true
    Expressions Allowed true
    Unit MILLISECONDS
    Storage configuration
    Access Type read-write
    Restart Required resource-services
    Stability community
  • sasl-protocol The name of the protocol to be passed to the SASL mechanisms used for authentication.
    • Deprecated Since 5.0.0
    Only for use with the legacy security realms.
    Attribute Value
    Default Value remote
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • secure-socket-binding The name of the socket binding configuration to use for the HTTPS management interface's socket. When defined at least one of ssl-context or security-realm must also be defined.
    • Attribute Value
    Capability reference
    Type STRING
    Nillable true
    Expressions Allowed false
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • server-name The name of the server used in the initial Remoting exchange and within the SASL mechanisms.
    • Deprecated Since 5.0.0
    Only for use with the legacy security realms.
    Attribute Value
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • socket-binding The name of the socket binding configuration to use for the HTTP management interface's socket.
    • Attribute Value
    Capability reference
    Type STRING
    Nillable true
    Expressions Allowed false
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • ssl-context Reference to the SSLContext to use for this management interface.
    • Attribute Value
    Capability reference
    Type STRING
    Nillable true
    Expressions Allowed false
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default

Operations (2)

  • add Adds the configuration of the server's HTTP management interface
    Request Parameter Type Required Expressions Allowed Default value Description
    allowed-origins LIST false true Comma separated list of trusted Origins for sending Cross-Origin Resource Sharing requests on the management API once the user is authenticated.
    backlog INT false true 50 The maximum number of pending connections on the socket.
    connection-high-water INT false true 100 The maximum number of connections that can be open at any one time.
    connection-low-water INT false true 75 The number of connections that the open count must reduce to before the connection-high-water level is reset.
    console-enabled BOOLEAN false true true Flag that indicates admin console is enabled
    constant-headers LIST false false The set of constant HTTP headers to apply to response messages.
    http-authentication-factory STRING false false The authentication policy to use to secure the interface for normal HTTP requests.
    http-upgrade OBJECT false false HTTP Upgrade specific configuration
    http-upgrade-enabled BOOLEAN false false Flag that indicates HTTP Upgrade is enabled, which allows HTTP requests to be upgraded to native remoting connections
    no-request-timeout INT false true 60000 The maximum time in milliseconds a connection can be idle without a HTTP request before it is closed.
    sasl-protocol STRING false true remote The name of the protocol to be passed to the SASL mechanisms used for authentication.
    secure-socket-binding STRING false false The name of the socket binding configuration to use for the HTTPS management interface's socket. When defined at least one of ssl-context or security-realm must also be defined.
    server-name STRING false true The name of the server used in the initial Remoting exchange and within the SASL mechanisms.
    socket-binding STRING false false The name of the socket binding configuration to use for the HTTP management interface's socket.
    ssl-context STRING false false Reference to the SSLContext to use for this management interface.
  • remove Adds the configuration of the server's HTTP management interface