GeneralSettingsUpdateSpecV2

GeneralSettingsUpdateSpecV2
GeneralSettingsUpdateSpecV2

Information related to General Settings.

JSON Example
{
    "application_sso_timeout_minutes": 30,
    "application_sso_timeout_policy": "ENABLED",
    "block_restricted_clients": false,
    "client_idle_session_timeout_minutes": 300,
    "client_idle_session_timeout_policy": "NEVER",
    "client_max_session_timeout_minutes": 300,
    "client_max_session_timeout_policy": "TIMEOUT_AFTER",
    "client_session_timeout_minutes": 300,
    "console_session_timeout_minutes": 30,
    "display_pre_login_message": false,
    "display_warning_before_forced_logoff": true,
    "enable_automatic_status_updates": true,
    "enable_credential_cleanup_for_htmlaccess": false,
    "enable_multi_factor_re_authentication": false,
    "enable_sending_domain_list": false,
    "enable_server_in_single_user_mode": true,
    "forced_logoff_message": "The system will shut down shortly. Please save your work.",
    "forced_logoff_timeout_minutes": 3,
    "hide_domain_list_in_client": true,
    "hide_server_information_in_client": false,
    "machine_sso_timeout_minutes": 300,
    "machine_sso_timeout_policy": "DISABLED_AFTER",
    "pre_login_message": "Disclaimer : This server is being monitored for suspicious activity.",
    "restricted_client_data_v2": [
        {
            "block_specific_versions": [
                "3.5,4",
                "4.0.1"
            ],
            "type": "WINDOWS",
            "version": 7.5,
            "warn_specific_versions": [
                "7.5,4",
                "5.0.2"
            ]
        }
    ],
    "restricted_client_message": "The system does not support this version of the Horizon client.",
    "restricted_client_warn_message": "This client version is not recommended. Please upgrade to the latest version.",
    "store_cal_on_client": false,
    "store_cal_on_connection_server": false
}
integer As int32 As int32
application_sso_timeout_minutes
Optional

The time allowed to elapse after a user has authenticated before the application SSO credentials are locked unless the user's Horizon client supports idle sessions and the user remains active.

string
application_sso_timeout_policy
Required

Specifies the policy for the maximum time after which single sign on will be disabled for application sessions.

  • DISABLED_AFTER: Single sign on will be disabled after the specified number of minutes has elapsed since the user connected to Horizon Connection Server.
  • DISABLED: Single sign on is disabled.
  • ENABLED: Single sign on is enabled.
Possible values are : DISABLED_AFTER, DISABLED, ENABLED,
boolean
block_restricted_clients
Optional

Indicates whether Horizon Client Connections are to be blocked if client is not part of restricted_client_data.

integer As int32 As int32
client_idle_session_timeout_minutes
Optional

Determines how long a user can be idle before the broker takes measure to protect the session.

string
client_idle_session_timeout_policy
Required

Specifies the policy for the maximum time that a that a user can be idle before the Connection Server takes measure to protect the session.

  • TIMEOUT_AFTER: The timeout is set for a configurable time.
  • NEVER: The timeout has been disabled.
Possible values are : TIMEOUT_AFTER, NEVER,
integer As int32 As int32
client_max_session_timeout_minutes
Optional

Determines how long a user can keep a session open after logging in to the Connection Server. When a session times out, the session is terminated and the Horizon client is disconnected from the resource. This property has a default value of 600 and a minimum value of 5. This property is required if Client Max Session Timeout Policy is set to TIMEOUT_AFTER.

string
client_max_session_timeout_policy
Required

Client max session lifetime policy. This property has a default value of TIMEOUT_AFTER. A value of TIMEOUT_AFTER indicates that the Horizon client session times out after a configurable session length. A value of NEVER indicates that the Horizon client session will not time out and will only end due to inactivity.

  • TIMEOUT_AFTER: The timeout is set for a configurable time.
  • NEVER: The timeout has been disabled.
Possible values are : TIMEOUT_AFTER, NEVER,
integer As int32 As int32
client_session_timeout_minutes
Required

Determines the maximum length of time that a session will be kept active if there is no traffic between the Horizon client and the Connection Server.

integer As int32 As int32
console_session_timeout_minutes
Optional

Determines how long an idle admin console session continues before the session times out.

boolean
display_pre_login_message
Optional

Indicates whether to show a disclaimer or other message when the Horizon Client user logs in. This change will take effect on next login for each user.

boolean
display_warning_before_forced_logoff
Optional

Indicates whether to display a warning message when users are forced to log off because a scheduled or immediate update such as a machine-refresh operation is about to start.

boolean
enable_automatic_status_updates
Optional

Enable updation of the global status of the application periodically. The Dashboard Information is also updated at regular intervals when Dashboard page is active.

boolean
enable_credential_cleanup_for_htmlaccess
Optional

Indicates whether to clean up session credentials when one tab connecting to remote machine/application is closed.

boolean
enable_multi_factor_re_authentication
Optional

Enables 2 factor re-authentication after idle session timeout.

boolean
enable_sending_domain_list
Optional

Indicates whether the domain list will be sent to the Horizon client. Since domain list will be sent before user is authenticated with server, it could disclose domain information to external users.

boolean
enable_server_in_single_user_mode
Optional

Permits RDSServer operating systems to be used for non-RDS Machines.

string
forced_logoff_message
Optional

The warning to be displayed before logging off the user.

integer As int32 As int32
forced_logoff_timeout_minutes
Optional

The time to wait after the warning is displayed and before logging off the user.

boolean
hide_domain_list_in_client
Optional

Whether to hide the list of domains in the Horizon client user interface. If value set to true, the user will need to provide a UPN (e.g. user@domain) or a logon name in the format domain\user when logging in.

boolean
hide_server_information_in_client
Optional

Indicates whether to hide the server URL in the Horizon client user interface.

integer As int32 As int32
machine_sso_timeout_minutes
Optional

Single sign on will be disabled after the specified time has elapsed since the user connected to Connection Server.

string
machine_sso_timeout_policy
Required

Specifies the policy for the maximum time after which single sign on will be disabled after a user connects to the Connection Server.

  • DISABLED_AFTER: Single sign on will be disabled after the specified number of minutes has elapsed since the user connected to Horizon Connection Server.
  • DISABLED: Single sign on is disabled.
  • ENABLED: Single sign on is enabled.
Possible values are : DISABLED_AFTER, DISABLED, ENABLED,
string
pre_login_message
Optional

Displays a disclaimer or another message to Horizon Client users when they log in. No message will be displayed if this is not set.

restricted_client_data_v2
Optional

List of restricted Horizon Clients.

string
restricted_client_message
Optional

The message to be displayed to Horizon clients which are blocked by the Connection Server.

string
restricted_client_warn_message
Optional

The message to be displayed to Horizon clients which are not recommended by the Connection Server.

boolean
store_cal_on_client
Required

Determines whether or not to store the RDS Per Device Client Access License on Horizon client devices. This value can be true only if Store Client Access License on Connection Server is true.

boolean
store_cal_on_connection_server
Required

Determines whether or not to store the RDS Per Device Client Access License on Broker.