Universal Messaging 10.1 | Administration Guide | Universal Messaging Enterprise Manager | Administration Using Enterprise Manager | TCP Interfaces, IP Multicast and Shared Memory | JavaScript Interface Panel
 
JavaScript Interface Panel
Universal Messaging HTTP and HTTPS (nhp and nhps) interfaces have configuration options specific to their communication with web clients using JavaScript. These options are accessible through the JavaScript panel when viewing an nhp or nhps interface.
The Interface Panel
JavaScript Interface Properties
Option Name
Description
Enable JavaScript
Recommended Setting: Enabled
Allows JavaScript clients to connect on this interface.
Enable WebSockets
Recommended Setting: Enabled
Toggles the ability for clients to communicate with the server using the HTML WebSocket Protocol on this interface.
CORS Allow Credentials
Recommended Setting: Enabled
Toggles the server sending an "Access-Control-Allow-Credentials: true" header in response to XHR-with-CORS requests from the client. This is required if the application, or website hosting the application, or intermediate infrastructure such as reverse proxy servers or load balancers, uses cookies.
Leave this enabled unless recommended otherwise by support. Disabling this will in most environments prevent all CORS-based drivers from working correctly.
CORS Allowed Origins
Recommended Setting: *
A comma separated list of the host names (and IP addresses, if they appear in URLs) of the server/s which host your JavaScript application's HTML. Use an * (asterisk) as a wildcard value if you do not wish to limit the hosts that can serve applications to clients. This server will accept and respond with the required Access-Control-Allow-Origin header when requests originate from a hostname in this list. This header allows CORS enabled transport mechanism to bypass cross site security restrictions in modern browsers.
It is important that this is set appropriately, or approximately half of the communication drivers available to JavaScript clients will fail.
Enable GZIP for LongPoll
Recommended Setting: Enabled
This will allow the server to gzip responses sent to LongPoll clients. This can reduce network utilization on servers with many LongPoll clients. It increases CPU resource utilization.
GZIP Minimum Threshold
Recommended Setting: 1000
The minimum message size is bytes required for the server to begin compressing data sent to LongPoll clients.
Long Poll Active Delay
Recommended Setting: 100
The time between clients sending long poll requests to the server in milliseconds. Reducing this may reduce latency up to a certain threshold but will increase both client and server memory, CPU and network usage.
Long Poll Idle Delay
Recommended Setting: 25000
The time between clients sending long poll when the client is in idle mode. A client is put in idle mode when no communication takes place between client and server for a period of time. Reducing this may be necessary if a client is timing out owing to local TCP/IP settings, proxy settings, or other infrastructure settings, but will result in higher memory, CPU and network usage on both the client and the server. It is however vital that this value is lower than the timeouts used in any intermediate proxy server, reverse proxy server, load balancer or firewall. Since many such infrastructure components have default timeouts of as little as 30 seconds, a value of less than 30000 would be prudent. If long polling client sessions continually disconnect and reconnect, then lower this value.
Custom Header Config
Header Key/Value pairs which are sent in the HTTP packets to the client.