Web Services configuration options
You can set the configuration options below the server-settings.yaml file on your Web Services node. For details, see Configuring Web Services.
URLs General
Timeouts |
Ops Account CME Credentials
Statistics |
Call Recording
CDR Multi-regional Support |
SSL and CA SAML CORS Elasticsearch Screen Recording Caching DoS Filter Account Management CometD |
URLs
externalApiUrlV2
Default Value: None
Valid Values: A public schema-based URL ending with /api/v2.
Mandatory: Yes
Specifies the prefix used for resources in the public API. In a development environment, the host and port should be set to the host name or IP address of the Web Services node. In a production environment, the host and port should be set to the host name or IP address of the load balancer in a production environment. For example, https://192.0.2.20/api/v2.
internalApiUrlV2
Default Value: None
Valid Values: A public schema-based URL ending with /internal-api.
Mandatory: Yes
Specifies the prefix used for internal resources. In a development environment, the host and port should be set to the host name or IP address of the Web Services node. In a production environment, the host and port should be set to the host name or IP address of the load balancer in a production environment. For example, http://192.0.2.20/internal-api.
General
iwsDispositionCodeSync
Default Value: true
Valid Values: true, false
Mandatory: No
Enables Web Services to synchronize disposition codes with Workspace Web Edition. To turn on this feature, set iwsDispositionCodeSync to true on all nodes (this is done by default), and set the syncNode option to true on one node.
temporaryAuthenticationTokenTTL
Default Value: 300
Valid Values: An integer greater than 0
Mandatory: No
Specifies the time to live, in seconds, for the temporary authentication token.
enableCsrfProtection
Default Value:
Valid Values: true, false
Mandatory: No
Enables cross site request forgery protection. If you set the value to true, make sure you use the default values for exposedHeaders in the crossOriginSettings option. If you have already updated the exposedHeaders, just make sure the values include the defaults.
salesforceAuthenticationMode
Please consult with Genesys for more information about how to use this option.
enableStaleSessionsMonitoring
Default Value: true
Valid Values: true, false
Mandatory: No
Specifies whether Web Services should run its StaleSessionsMonitor process to periodically poll Cassandra for expired CometD sessions. This process releases any devices that might not have been released as part of EndContactCenterSession if CometD session information was lost.
staleSessionsMonitorSettings
Default Value: None
Valid Values:
Name | Mandatory | Default Value | Description |
---|---|---|---|
monitoringInterval | No | 60 | Specifies, in seconds, how often Web Services scans for expired CometD sessions. |
expiredSessionAge | No | 180 | Specifies the age, in seconds, at which Web Services considers the CometD session to be expired. |
Mandatory: No
Specifies the configuration for monitoring expired CometD sessions. For example:
...
staleSessionsMonitorSettings:
monitoringInterval: 60
expiredSessionAge: 180
Timeouts
activationTimeout
Default Value: 12000
Valid Values: An integer greater than 0
Mandatory: No
Specifies the timeout, in milliseconds, for connecting to any Genesys server (except Configuration Server). This may include several individual attempts if the initial attempt to connect is unsuccessful.
configServerActivationTimeout
Default Value: 35000
Valid Values: An integer greater than 0
Mandatory: No
Specifies the timeout, in milliseconds, for connecting to Configuration Server. This may include several individual attempts if the initial attempt to connect is unsuccessful.
configServerConnectionTimeout
Default Value: 15000
Valid Values: An integer greater than 0
Mandatory: No
Specifies the timeout, in milliseconds, for an individual connection attempt to Configuration Server.
connectionTimeout
Default Value: 4000
Valid Values: An integer greater than 0
Mandatory: No
Specifies the timeout, in milliseconds, for an individual connection attempt to any Genesys server (except Configuration Server).
contactCenterSynchronizationTimeout
Default Value: 60000
Valid Values: An integer greater than 0
Mandatory: No
Specifies how often the syncNode looks for newly created contact centers.
inactiveUserTimeout
Default Value: 60
Valid Values: An integer greater than 0
Mandatory: No
Specifies the interval, in seconds, at which the inactive user cleanup process is run by the server. This process is run to invalidate HTTP sessions for users who have been deleted or whose user roles have changed.
reconnectAttempts
Default Value: 1
Valid Values: An integer greater than 0
Mandatory: Yes
Specifies the number of attempts Web Services makes to connect to any Genesys server before attempting to connect to the backup.
reconnectTimeout
Default Value: 10000
Valid Values: An integer greater than 0
Mandatory: Yes
Specifies the timeout, in milliseconds, between the reconnect attempts.
Ops Account
opsUserName
Default Value: None
Valid Values: Any alphanumeric value that can include special characters
Mandatory: Yes
Specifies the name of the Web Services super user. Web Services creates this user at startup.
opsUserPassword
Default Value: None
Valid Values: Any alphanumeric value, including special characters
Mandatory: Yes
Specifies the password for the Web Services super user. Web Services creates this user at startup.
CME Credentials
applicationName
Default Value: None
Valid Values: A valid application name
Mandatory: Yes
The name of the Web Services node application object in Configuration Server. For example, WS_Node.
applicationType
Default Value: None
Valid Values: A valid application type
Mandatory: Yes
The type of the Web Services node application object in Configuration Server. This value should be CFGGenericClient.
cmeUserName
Default Value: None
Valid Values: A valid Configuration Server user
Mandatory: Yes
The username that the Web Services server uses to connect to Configuration Server.
cmePassword
Default Value: None
Valid Values: A valid password
Mandatory: Yes
The password for the Configuration Server user Web Services uses to connect to Configuration Server.
syncNode
Default Value: None
Valid Values: true, false
Mandatory: No
Specifies whether the node is the synchronization node. This node is responsible for importing objects from Configuration Server into Cassandra, subscribing to changes notifications with Configuration Server, and processing updates.
synchronizationCmeEventsPrefilterEnabled
This option is deprecated in 8.5.2.
enableVirtualQueueSynchronization
Default Value: false
Valid Values: true, false
Mandatory: No
Specifies whether the syncNode imports virtual queues from CME.
Statistics
statConnectionTimeout
Default Value: 5000
Valid Values: A positive integer greater than 0
Mandatory: No
Specifies the connection timeout, in milliseconds, for connecting to Stat Server.
statReconnectAttempts
Default Value: 1
Valid Values: A positive integer
Mandatory: No
Specifies the number of reconnect attempts before switching to the backup Stat Server, if the connection to the primary Stat Server is lost.
statReconnectTimeout
Default Value: 10000
Valid Values: An integer greater than 0
Mandatory: No
Specifies the timeout, in milliseconds, before reconnecting to Stat Server.
statOpenTimeout
Default Value: 60000
Valid Values: An integer greater than 0
Mandatory: No
Specifies the timeout, in milliseconds, between when a request is sent to Stat Server to open a statistic and when Web Services server determines the statistic has not been opened. If the timeout expires, the Web Services server discards the request and sends a new one.
statisticsMonitorMultimediaChannelStates
Default Value: false
Valid Values: true, false
Mandatory: No
Specifies whether to monitor user states on non-voice channels.
statisticsWritesCL
This option is no longer applicable as of release 8.5.201.09.
reportingSyncInterval
Default Value: 30
Valid Values: An integer greater than 0
Mandatory: No
Specifies the interval, in seconds, for the reporting services to poll the database for information about the activities of other monitoring nodes and for the current state of the contact center configuration. If you set this option to a larger value, it decreases the load on the database, but also increases the timeout for detecting nodes that are down and objects that are added or updated in contact centers.
enableElasticSearchIndexing
Default Value: false
Valid Values: true, false
Mandatory: No
Specifies whether the configuration information and statistics should be indexed to Elasticsearch. If set to true, you must set the crClusterName option.
statisticsOpenRetryInterval
Default Value: 60 (1 hour)
Valid Values: An integer greater than 0
Mandatory: No
Specifies the interval, in minutes, for trying to reopen failed statistics. For example, if a statistic cannot be opened on Stat Server, it is marked as failed and then the server attempts to reopen the stat once every hour (the default value of statisticsOpenRetryInterval).
Call Recording
createCallRecordingCF
Default Value: false
Valid Values: true, false
Mandatory: No
If set to true, the column families in Cassandra are created to support call recording. If false, call recording is not supported.
crClusterName
Default Value: None
Valid Values: A valid cluster name
Mandatory: No
Specifies the name of the cluster to enable search functionality in Elasticsearch. If this option is not present, search functionality is not enabled.
crRegion
Default Value: None
Valid Values: String
Mandatory: No
Specifies the name of the region where the Web Services node is located.
awsS3AccessKey
This option is deprecated in 8.5.2.
awsS3SecretKey
This option is deprecated in 8.5.2.
awsS3BucketName
This option is deprecated in 8.5.2.
awsS3SocketTimeout
Default Value: 50000
Valid Values: An integer greater than 0
Mandatory: No
Specifies the amount of time to wait, in milliseconds, for data to be transferred over an established connection.
awsS3MaxErrorRetry
Default Value: 3
Valid Values: An integer greater than or equal to 0
Mandatory: No
Specifies the maximum number of retry attempts for failed requests. For example, 5xx error responses from services.
awsS3MaxConnection
Default Value: 50
Valid Values: An integer greater than 0
Mandatory: No
Specifies the maximum number of allowed open HTTP connections.
awsS3ConnectionTimeout
Default Value: 50000
Valid Values: An integer greater than 0
Mandatory: No
Specifies the amount of time to wait, in milliseconds, when initially establishing a connection before giving up and timing out.
cryptoSecurityKey
Default Value: None
Valid Values: A valid security key
Mandatory: No
Specifies the security key used for encryption for call recording settings stored in the database.
webDAVMaxConnection
Default Value: 50
Valid Values: An integer greater than 0
Mandatory: No
Specifies the maximum value of the WebDAV client TCP connection to each route. When WebDAV client's requests to same the WebDAV server are less than this value, a new TCP connection will be established for better performance. Otherwise, the new request will be en-queue until any ongoing request finishes.
webDAVMaxTotalConnection
Default value: 10 * value of webDAVMaxConnection
Valid Values: An integer greater than 0
Mandatory: No
Specifies the maximum number of TCP connections from the Web Services node to all WebDav storage.
CDR
voiceMonitorNodeId
Default Value: Null
Valid Values: A unique ID — for example, the node host name or IP address.
Mandatory: No
Specifies the unique ID of Web Services node. You must set this option on all the WWE&WS nodes in order to enable call detail recording.
Multi-regional Support
nodePath
Default Value: None
Valid Values: A location and node ID, separated by a "/" — for example, /US/node1
Mandatory: Yes
Specifies the location and ID of the Web Services node within the deployment topology. This value must be unique across the deployment. For example, a value of /US/node1 means that the node is located in the US region and has an ID of "node1". The node ID can be the hostname, the IP address, or any other unique identifier.
nodeId
Default Value: None
Valid Values: Any unique identifier, such as the node host name or IP
Mandatory: No
Specifies the unique identifier for the Web Services node. Each node in a cluster must have a unique nodeId.
SSL and CA
caCertificate
Default Value: None
Valid Values: Path to a signed certificate
Mandatory: No
Specifies the path to a certificate signed by a Certificate Authority. The file must be in the .pem or .jks format (if .jks, you can also set jksPassword). The certificate can be used if the WWE&WS Cluster application uses Transport Layer Security (TLS) to connect to Genesys servers. This option is also mandatory to enable SAML authentication.
jksPassword
Default Value: None
Valid Values: Password for the key storage
Mandatory: No
Specifies the password for the key storage set in caCertificate, when the certificate is in .jks format. This option is mandatory to enable SAML authentication.
SAML
samlSettings
Default Value: None
Valid Values:
Name | Mandatory | Default Value | Description |
---|---|---|---|
serviceProviderEntityId | No | If omitted, Web Services uses the value of the externalApiUrlV2 option. | Specifies the service provider entity ID to be used in the metadata. |
encryptionKeyName | Yes | None | Specifies the Security Assertion Markup Language (SAML) encryption key name. This key has to be present in the JKS key storage specified in the caCertificate option. |
encryptionKeyPassword | No | If omitted, Web Services uses the value of the jksPassword option. | Specifies the password used to extract the SAML encryption key from JKS storage. |
signMetadata | No | true | Specifies whether generated metadata is signed with an XML signature that uses the certificate with the alias of signingKeyName. |
signingKeyName | Yes | None | Specifies the SAML signing key name. This key has to be present in the JKS key storage specified in the caCertificate option. |
signingKeyPassword | No | If omitted, Web Services uses the value of the jksPassword option. | Specifies the password used to extract the SAML signing key from JKS storage. |
tlsKeyName | No | None | Specifies the TLS key name. This key has to be present in the JKS key storage specified in the caCertificate option. |
tlsKeyPassword | No | If omitted, Web Services uses the value of the jksPassword option. | Specifies the password used to extract the SAML TLS key from JKS storage. |
responseSkewTime | No | 60 | Specifies the maximum difference, in seconds, between the local time and time of the assertion creation which still allows message to be processed. Determines the maximum difference between clocks of the IDP and SP servers. |
defaultBinding | No | SSO_ARTIFACT | Specifies the default SAML binding GWS uses. The valid values are: SSO_POST, SSO_PAOS, SSO_ARTIFACT, HOKSSO_POST, or HOKSSO_ARTIFACT. |
requestSigned | No | true | Specifies whether this service signs authentication requests. |
wantAssertionSigned | No | true | Specifies whether this service requires signed assertions. |
identityProviderMetadata | Yes | None | Specifies the path or URL for the identity provider XML metadata file. You can set this option to the path to a physical location or, if the metadata file is exposed by the remote server over HTTP, you can specify the URL (in this case, Web Services applies a 5-second default request timeout). |
secureRelayState | No | false | If false, the RelayState attribute Web Services passes to the Identity Provider during SAML authentication contains the original URL (from the "referer" header) requested by the client. If true, Web Services instead saves the original RelayState in Cassandra and uses an alphanumeric token that can identify the RelayState. |
secureRelayStateTTL | No | 3600 (1 hour) | Specifies, in seconds, the time-to-live for the RelayState record in Cassandra. This setting is only used if secureRelayState is set to true. |
useExternalUserId | No | false | Specifies whether Web Services should use the external user ID, a property of the CfgPerson object in CME, for SAML authentication. If false, Web Services uses the username. If true, Web Service uses the external user ID. |
Mandatory: No
Specifies the configuration for Security Assertion Markup Language (SAML) authentication for Web Services. For example:
...
samlSettings:
serviceProviderEntityId: 10.10.15.60
encryptionKeyName: client
signingKeyName: client
identityProviderMetadata: http://ipd.company.host/saml/metadata/idp-metadata.xml
responseSkewTime: 120
defaultBinding: SSO_POST
CORS
crossOriginSettings
Default Value: None
Valid Values:
Name | Mandatory | Default Value | Description |
---|---|---|---|
allowedOrigins | No | None | Specifies a comma-separated list of allowed origins supported by this Web Services node. For example, http://*.genesys.com, http://*.genesyslab.com |
allowedMethods | No | GET,POST,PUT,DELETE,OPTIONS | Specifies a comma-separated list of HTTP methods supported by the server. |
allowedHeaders | No | X-Requested-With,Content-Type,Accept,Origin,Cookie,authorization,ssid,surl,ContactCenterId | Specifies whether to include the Access-Control-Allow-Headers header as part of the response to a pre-flight request. This specifies which header field names can be used during the actual request. |
allowCredentials | No | true | Specifies the value of the Access-Control-Allow-Credentials header. This should typically be left at the default value. |
corsFilterCacheTimeToLive | No | 120 | Specifies the delay after the contact center allowDomain updating takes effect. |
exposedHeaders | No | X-CSRF-HEADER,X-CSRF-TOKEN | Specifies which custom headers are allowed in cross-origin HTTP responses. This should typically be left at the default value. If you do modify the value and you enable the enableCsrfProtection option, make sure the value for exposedHeaders includes X-CSRF-HEADER,X-CSRF-TOKEN. |
Mandatory: No
Specifies the configuration for cross-origin resource sharing in Web Services. For example:
...
crossOriginSettings:
corsFilterCacheTimeToLive: 120
allowedOrigins: http://*.genesys.com, http://*.genesyslab.com
allowedMethods: GET,POST,PUT,DELETE,OPTIONS
allowedHeaders: "X-Requested-With,Content-Type,Accept,Origin,Cookie,authorization,ssid,surl,ContactCenterId"
allowCredentials: true
exposedHeaders: "X-CSRF-HEADER,X-CSRF-TOKEN"
Elasticsearch
elasticSearchSettings
Default Value: None
Valid Values:
Name | Mandatory | Default Value | Description |
---|---|---|---|
clientNode | No | false | Specifies whether the current Web Services node acts as an Elasticsearch client or server. |
indexPerContactCenter | No | false | Enables indexing on a per-contact center basis. If false, there is only one index for all current statistics. |
enableScheduledIndexVerification | No | false | Enables scheduled index verification on the WWE&WS node. This means that the node goes through all objects handled by Elasticsearch and makes sure they still exist in Cassandra and vice versa. |
indexVerificationInterval | No | 720 minutes (12 hours) | Specifies an interval, in minutes, between index verifications for this WWE&WS node. |
enableIndexVerificationAtStartUp | No | true | Enables index verification at start-up on this node. This means that, at start-up, the node goes through all objects handled by Elasticsearch and makes sure they still exist in Cassandra and vice versa. |
retriesOnConflict | No | 3 | Controls how many times to retry if there is a version conflict when updating a document. |
useTransportClient | No | false | Specifies whether Web Services should use a transport client for Elasticsearch. If true, then Web Services ignores the clientNode setting. |
transportClient | Yes, if useTransportClient is true. | Values specified in TransportClientSettings | Specifies the configuration Web Services should use for the transport client. For details see TransportClientSettings in the next table. |
TransportClientSettings
Name | Mandatory | Default Value | Description |
---|---|---|---|
nodes | Yes, if useTransportClient is true. | null | Specifies the list of Elasticsearch nodes the transport client should connect to. |
useSniff | no | false | Specifies if the transport client should us sniffing functionality and perform auto-discovery of Elasticsearch nodes in the cluster. |
ignoreClusterName | no | false | Specifies if Web Services should ignore the name of the cluster when connecting to the cluster. |
pingTimeout | no | 5000 | Specifies, in milliseconds, the ping timeout for Elasticsearch nodes. |
nodesSamplerInterval | no | 5000 | Specifies, in milliseconds, how often Web Services should sample/ping the Elasticsearch nodes listed and connected. |
Mandatory: No
Specifies the configuration for Elasticsearch in Web Services. For example:
...
elasticSearchSettings:
clientNode: true
indexPerContactCenter: false
enableScheduledIndexVerification: true
indexVerificationInterval: 60
retriesOnConflict: 2
useTransportClient: true
transportClient:
nodes:
- {host: 127.0.0.1, port: 9300}
useSniff: true
ignoreClusterName: true
pingTimeout: 10000
nodesSamplerInterval: 10000
Screen Recording
screenRecordingSettings
Default Value: None
Valid Values:
Name | Mandatory | Default Value | Description |
---|---|---|---|
screenRecordingVoiceEnabled | No | false | Specifies whether the current Web Services node supports screen recording for voice interactions. If false, the node rejects CometD requests from the ScreenRecording Client for agents with the voice channel. |
screenRecordingEServicesEnabled | No | false | Specifies whether the current WWE&WS node supports screen recording for non-voice interactions. If false, the node rejects CometD requests from the ScreenRecording Client for agents with the eServices channel. |
recordingInteractionEventsTTL | No | 172800 | Specifies the time to live (TTL) for Cassandra to cache a screen recording interaction event. |
clientSessionManagerCacheTTL | No | 60 | Specifies the TTL for the WWE&WS node to cache agent information (such as the agent's name) so that the node doesn't have to read the information from Web Services on each request. |
contactCenterInfoManagerCacheTTL | No | 90 | Specifies the TTL for the WWE&WS node to cache contact center information so that the node doesn't have to read the information from Web Services on each request. |
Mandatory: No
Specifies the screen recording configuration parameters. For example:
...
screenRecordingSettings:
screenRecordingVoiceEnabled: false
screenRecordingEServicesEnabled: false
recordingInteractionEventsTTL: 172800
clientSessionManagerCacheTTL: 60
contactCenterInfoManagerCacheTTL: 90
Caching
cachingSettings
Default Value: None
Valid Values:
Name | Mandatory | Default Value | Description |
---|---|---|---|
enableSystemWideCaching | No | false | Specifies if caching will be used system-wide (true) or only during statistics evaluation (false). |
agentStatesTTL | No | 30 | The time to live (TTL), in seconds, for contact-center agent states in cache. |
contactCenterFeaturesTTL | No | 30 | The TTL, in seconds, for contact-center feature IDs in cache. |
contactCenterSettingsTTL | No | 30 | The TTL, in seconds, for contact-center custom settings in cache. |
voiceContextCaching | No | false | Specifies whether to use in-memory cached context for processing voice events. Using caching reduces the processing time, but you can expect delays in configuration information propagation. |
voiceContextRefreshInterval | No | 30 | The interval, in seconds, between refreshes of the context caches for voice event processing. The service reads configuration information from the database and then refreshes the corresponding caches. |
Mandatory: No
Specifies how Web Services should handle various caching scenarios. For example:
...
cachingSettings:
enableSystemWideCaching: true
agentStatesTTL: 30
contactCenterFeaturesTTL: 30
contactCenterSettingsTTL: 30
voiceContextCaching: true
voiceContextRefreshInterval: 60
DoS Filter
enableDosFilter
Default Value: false
Valid Values: true, false
Mandatory: No
Enables the denial of service filter. If you set the value to true, you must also set values for the dosFilterSettings option.
dosFilterSettings
Default Value: None
Valid Values:
Name | Mandatory | Default Value | Description |
---|---|---|---|
maxRequestsPerSec | No | 25 | Specifies the maximum number of requests from a connection per second. Requests that exceed this are first delayed, then throttled. |
delayMs | No | 100 | Specifies the delay, in milliseconds, imposed on all requests over the rate limit, before they are considered at all. Valid values:
|
maxWaitMs | No | 50 | Specifies the length of time, in milliseconds, to blocking wait for the throttle semaphore. |
throttledRequests | No | 5 | Specifies the number of requests over the rate limit that are able to be considered at once. |
throttleMs | No | 30000 | Specifies the length of time, in milliseconds, to asynchronously wait for semaphore. |
maxRequestMs | No | 30000 | Specifies the length of time, in milliseconds, to allow the request to run. |
maxIdleTrackerMs | No | 30000 | Specifies the length of time, in milliseconds, to keep track of request rates for a connection, before deciding that the user has gone away, and discarding the connection. |
insertHeaders | No | true | If true, DoSFilter headers are inserted into the response. |
trackSessions | No | true | If true, the usage rate is tracked by session if a session exists. |
remotePort | No | false | If true and session tracking is not used, then the rate is tracked by IP + port (effectively connection). |
ipWhitelist | No | "" | A comma-separated list of IP addresses that is not rate limited. |
Mandatory: No
Specifies how Web Services should handle denial of service. For example:
...
enableDosFilter: true
dosFilterSettings:
maxRequestsPerSec: 30
ipWhitelist: 192.168.0.1,192.168.0.2
These options only take effect if enableDosFilter is set to true.
Account Management
accountManagement
Default Value: None
Valid Values:
Name | Mandatory | Default Value | Description |
---|---|---|---|
forgotPasswordEmailTemplate | No | None | The template to use for an email that is sent to a user who forgets his or her password.
forgotPasswordEmailTemplate:
from: <from address>
subject: <Subject line>
body: <Email body> |
accountCreatedEmailTemplate | No | None | The template to use for a email that is sent to a user who creates a new account.
accountCreatedEmailTemplate:
from: <from address>
subject: <Subject line>
body: <Email body> |
smtpServer | No | None | The SMTP server configuration information.
smtpServer:
host: <smtp host name>
port: <smtp port>
userName: <user name for the account>
password: <password in plain text>
timeout: <optional SMTP timeout> |
Mandatory: No
Specifies the configuration for the email notification and email server used when creating a new user. This option accepts the email server's login configuration, as well as email templates for resetting and creating user passwords. For example:
accountManagement:
forgotPasswordEmailTemplate:
from: <from address>
subject: <Subject line>
body: <Email body>
accountCreatedEmailTemplate:
from: <from address>
subject: <Subject line>
body: <Email body>
smtpServer:
host: <smtp host name>
port: <smtp port>
userName: <user name for the account>
password: <password in plain text>
timeout: <optional SMTP timeout>
CometD
cometDSettings
Default Value: None
Valid Values:
Name | Mandatory | Default Value | Description |
---|---|---|---|
cometdSessionExpirationTimeout | No | 60 | Specifies the timeout for the CometD session to expire on disconnect. It might take an additional minute for the session to be closed after it expires. If you set this option to -1, the session never expires. An agent can login again before the end of this timeout to disable session expiration. |
closeHttpSessionOnCometDExpiration | No | true | Enables or disables HTTP session invalidation when CometD times out. |
maxSessionsPerBrowser | No | 1 | The maximum number of sessions (tabs/frames) allowed to long poll from the same browser; a negative value allows unlimited sessions. |
multiSessionInterval | No | 2000 | Specifies the period of time, in milliseconds, for the client normal polling period, in case the server detects more sessions (tabs/frames) connected from the same browser than allowed by the maxSessionsPerBrowser parameter. A non-positive value means that additional sessions will be disconnected. |
Mandatory: No
Specifies the configuration for the CometD-specific transport server embedded into the Web Services application. For example:
cometDSettings:
cometdSessionExpirationTimeout: 60
closeHttpSessionOnCometDExpiration: true
maxSessionsPerBrowser: 2
multiSessionInterval: 4000