On this page:
   25.51    HTTP Access Log 25.53    HTTP Request Pool   

25.52HTTP Listener

 

The HTTP Listener configuration category includes the following configurable options:

  • Listener Port

  • Context Path

  • Endpoint Health Path

  • Respect Forward Headers

  • HTTPS Forwarding Assumed

25.52.1Property: Listener Port

 
Property Name Listener Port
Property Key
Property Type POSITIVE_INTEGER
Description The TCP port on which this module listens.
Default Value (no default)
Example Property
module.[MODULE_ID].config.port = 

25.52.2Property: Context Path

 
Property Name Context Path
Property Key
Property Type STRING
Description This setting provides the path at the given port that this server will listen on. By default the server simply listens at the / path, but this could be changed to a sub-path for some network architectures. For example, if a reverse proxy is proxying the server but also serving other endpoints with the same port at different paths, this setting can be used as a hint to this server as to which path should be used. If a reverse proxy is serving this server in such a way that a request to the proxy at /baseurl/foo/index.html should map to /index.html on this server, you should put /baseurl/foo as the context root.
Default Value /
Example Property
module.[MODULE_ID].config.context_path = /

25.52.3Property: Endpoint Health Path

 
Property Name Endpoint Health Path
Property Key
Property Type STRING
Description Specifies a path (in the form /path/to/endpoint) that will be used as the Endpoint Health Check path. See Endpoint Health for information on this feature.
Default Value /endpoint-health
Example Property
module.[MODULE_ID].config.endpoint_health.path = /endpoint-health

25.52.4Property: Respect Forward Headers

 
Property Name Respect Forward Headers
Property Key
Property Type BOOLEAN
Description If enabled, the server will respect values provided by the client in the HTTP Forward, X-Forwarded-For, X-Forwarded-Host, and X-Forwarded-Proto headers. These headers are useful in cases where Smile CDR is being served behind a reverse proxy. This setting should be disabled if the server is not behind a proxy since this could allow clients to masquerade their source IP, which is a security risk. See Respecting Forward Headers for more information.
Default Value false
Example Property
module.[MODULE_ID].config.respect_forward_headers = false

25.52.5Property: HTTPS Forwarding Assumed

 
Property Name HTTPS Forwarding Assumed
Property Key
Property Type BOOLEAN
Description If enabled, the server will treat incoming requests as though they were secure even if they are not. This is useful in order to force redirects to use HTTPS in environments where the X-Forwarded-Proto does not reliably get passed from network infrastructure in front of Smile CDR to Smile CDR.
Default Value false
Example Property
module.[MODULE_ID].config.https_forwarding_assumed = false
   25.51    HTTP Access Log 25.53    HTTP Request Pool