Jump to: navigation, search

security.session-lock-set-agent-not-ready

Section: interaction-workspace
Default Value: false
Valid Values: true, false
Changes Take Effect: When the application is started or restarted.
Introduced: 8.5.139.06

Specifies whether the agent status is switched to Not Ready automatically when the Windows session is locked while the agent state is Ready.

security.session-lock-not-ready-reason

Section: interaction-workspace
Default Value: No default value
Valid Values: A valid Not Ready reason
Changes Take Effect: When the application is started or restarted.
Introduced: 8.5.139.06

Specifies the Not Ready Reason used when the agent status is set to the Not Ready on session lock. Depends on security.session-lock-set-agent-not-ready.

security.session-lock-force-not-ready-state

Section: interaction-workspace
Default Value: false
Valid Values: true, false
Changes Take Effect: When the application is started or restarted.
Introduced: 8.5.139.06
Related Options: security.session-lock-not-ready-reason, security.session-lock-set-agent-not-ready

Specifies whether channels that are already in a Not Ready status (with or without a Not Ready Reason) are switched to the Not Ready reason specified by the security.session-lock-not-ready-reason option when the agent is set to Not Ready when their workstation is locked. If the value of this option is set to false, only the status of channels in the Ready and After Call Work statuses are updated. Depends on security.session-lock-set-agent-not-ready.

security.inactivity-timeout

Section: interaction-workspace
Default Value: 0
Valid Values: Any integer from 0 through 100.
Changes Take Effect: When the application is started or restarted.


Specifies the amount of time in minutes of agent inactivity (no mouse or keyboard usage) that triggers application locking. If the agent has been inactive longer than the number of minutes that are specified by the inactivity timeout, the agent must reauthenticate to be able to use the Workspace application. A value of 0 disables this functionality.

security.inactivity-set-agent-not-ready

Section: interaction-workspace
Default Value: true
Valid Values: true, false
Changes Take Effect: When the application is started or restarted.


Specifies whether the agent is automatically set to Not Ready when agent inactivity is detected.

security.inactivity-not-ready-reason

Section: interaction-workspace
Default Value:
Valid Values: A valid not ready reason
Changes Take Effect: When the application is started or restarted.
Dependencies: inactivity.set-agent-not-ready

Specifies the Not Ready Reason if the inactivity.set-agent-not-ready option is set to true.

security.inactivity-force-not-ready-state

Section: interaction-workspace
Default Value: false
Valid Values: true, false
Changes Take Effect: When the application is started or restarted.
Introduced: 8.5.139.06

Specifies whether channels that are in a Not Ready status (with or without a Not Ready Reason) are forced to new Not Ready Reason status specified by the security.inactivity-not-ready-reason option when workstation is locked. If the value of this option is set to false, only the status of channels with Ready and After Call Work statuses are updated. Depends on security.inactivity-set-agent-not-ready.

security.enable-debug-information

Section: interaction-workspace
Default Value: false
Valid Values: true, false
Changes Take Effect: Immediately.


For the About window, this option specifies whether agents are able to display the controls that provide quick access to the Executable directory, the Log directory, the GC, and so on, if they CTRL+Click the Genesys logo in the About box.

security.disable-rbac

Section: interaction-workspace
Default Value: false
Valid Values: true, false
Changes Take Effect: When the application is started or restarted.


Disables role based access (RBAC). If this option is set to true, all the Workspace tasks are available to the agents. If this option is set to false, the list of agent tasks must be defined in Genesys Administrator.

security.client-authentication-certificate-search-value

Section: interaction-workspace
Default Value: Empty
Valid Values: A string value or one of the supported field codes, Workspace uses to select a certificate.
Changes Take Effect: When the application is started or restarted.


For mutual TLS only. Specifies a string or one of the supported field codes that Workspace should use to select a certificate from the Windows Certificate Store to be used on the client-side to authenticate to server.

Search order with this value is:

  1. The certificate Thumbprint.
  2. The certificate Subject with this value, such as: Email, Common Name, Organizational Unit, and so on.
  3. The certificate Subject Alternative Name with this value.

Supported field codes:

  • $Agent.UserName$: The User Name.
  • $Agent.UPN$: The Explicit User Principal Name (eUPN) specified in the Windows Active Directory by the Windows Administrator when provisioning the agent account. This mode is deprecated and should be substituted by implicitUPN.
  • $Agent.ImplicitUPN$: The Implicit User Principal Name (iUPN), which is a combination of the samAccountName and the user's Domain.
  • $Agent.SAMAccountName$: The SAM Account Name attribute in the Windows Active Directory specified by the Windows Administrator when provisioning the agent account.
  • $Agent.MachineName$: The Machine Name attribute.
  • $Agent.MachineNameWithDomain$: The period (.) separated combination of Machine Name and Domain attributes.

Note: For authenticated connection to Configuration Server, this option should be present in the local InteractionWorkspace.exe.config configuration file.

This page was last edited on July 5, 2023, at 08:12.
Comments or questions about this documentation? Contact us for support!