GeneralSettingsUpdateSpecV4

GeneralSettingsUpdateSpecV4
GeneralSettingsUpdateSpecV4

General settings object to be updated.

JSON Example
{
    "api_session_timeout_minutes": 30,
    "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_admin_banner": false,
    "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,
    "enable_user_name_caching": 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_admin_banner_header": "Attention",
    "pre_login_admin_banner_message": "On proceeding, you agree that you fully comply with the laws of this organisation.",
    "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.",
    "sso_discard_connection_type": "BOTH",
    "store_cal_on_client": false,
    "store_cal_on_connection_server": false
}
integer As int32 As int32
api_session_timeout_minutes
Optional

Determines how long (in minutes) a refresh token is valid for and an idle View API session continues before the session times out.
Setting the API session timeout to a high number of minutes increases the risk of unauthorized use of View API.
Use caution when you allow an idle session to persist for a long time.
Default value is 10.

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_admin_banner
Required

Enable/disable pre login message pop up before logging into Horizon admin console

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.

boolean
enable_user_name_caching
Optional

UI Client provide 'remember me' option when this is set to true.
Default value is true.

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_admin_banner_header
Optional

The warning pop up header to be displayed before logging into Horizon admin console, if pre login message pop up is activated for the same.

string
pre_login_admin_banner_message
Optional

The warning pop up message to be displayed before logging into Horizon admin console, if pre login message pop up is activated for the same.

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.

string
sso_discard_connection_type
Optional

The type of connection for which the single sign on discard timeout minutes should be applied.

  • NONE: Indicates the connections from client devices on neither private networks nor non-private networks.
  • INTERNAL: Indicates the connections from client devices on private networks.
  • EXTERNAL: Indicates the connections from client devices on non-private networks.
  • BOTH: Indicates the connections from client devices both on private and non-private networks.
Possible values are : NONE, INTERNAL, EXTERNAL, BOTH,
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.