Get General Settings V4

Get General Settings V4

All the listed privileges are required -

Privileges Description
GLOBAL_CONFIG_VIEW Caller should have permission to this privilege, to read settings.
Request
URI
GET
https://{api_host}/rest/config/v4/settings/general
COPY
Authentication
This operation uses the following authentication methods.
Responses
200

OK

Returns GeneralSettingsV4 of type(s) */*
{
    "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,
    "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.

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
Optional

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 Connection Server takes measure to protect the session.

string
client_idle_session_timeout_policy
Optional

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 clientMaxSessionTimeoutPolicy is set to TIMEOUT_AFTER.

string
client_max_session_timeout_policy
Optional

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
Optional

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
Optional

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.

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
Optional

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
Optional

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
Optional

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


401

User is not authenticated

Operation doesn't return any data structure

403

Access to the resource is forbidden

Operation doesn't return any data structure

Config Operations
POST
Add App Volumes Manager
POST
Add App Volumes Manager V2
POST
Assign Farms
POST
Clean
POST
Clear Event Database
POST
Collect
POST
Create Federation Access Group
POST
Create Gateway Access User Or Group
POST
Create GSSAPI Authenticator
POST
Create IC Domain Account
POST
Create IM Asset
POST
Create IM Assets
POST
Create IM Stream
POST
Create IM Streams
POST
Create IM Tag
POST
Create IM Tags
POST
Create IM Version
POST
Create IM Versions
POST
Create JWT Authenticator
POST
Create Local Access Group
POST
Create Message Client
POST
Create Permissions
POST
Create Permissions V2
POST
Create RADIUS Authenticator
POST
Create Role
POST
Create SAML Authenticator
POST
Create Secondary Credential
POST
Create True SSO Connector
POST
Create Unauthenticated Access User
POST
Create Virtual Center
POST
Create Virtual Center V4
POST
Create Virtual Center V5
DELETE
Delete App Volumes Manager
DELETE
Delete App Volumes Manager V2
DELETE
Delete Certificate
DELETE
Delete Federation Access Group
DELETE
Delete Gateway Access User Or Group
DELETE
Delete GSSAPI Authenticator
DELETE
Delete IC Domain Account
DELETE
Delete IM Asset
DELETE
Delete IM Stream
DELETE
Delete IM Tag
DELETE
Delete IM Version
DELETE
Delete JWT Authenticator
DELETE
Delete Local Access Group
DELETE
Delete Message Client
DELETE
Delete Permissions
DELETE
Delete Permissions V2
DELETE
Delete RADIUS Authenticator
DELETE
Delete Role
DELETE
Delete SAML Authenticator
DELETE
Delete Secondary Credential
DELETE
Delete True SSO Connector
DELETE
Delete Unauthenticated Access User
POST
Disable Connection Servers
POST
Enable Connection Servers
POST
Export Certificate
POST
Generate CSR
GET
Get Admin Users Or Groups Permissions
GET
Get AD Sites Info
GET
Get Agent Restriction Settings
GET
Get App Volumes Manager
GET
Get App Volumes Manager V2
GET
Get CEIP Info
GET
Get Client Settings
GET
Get Connection Server
GET
Get Connection Server V2
GET
Get Enrollment Server
GET
Get Environment
GET
Get Environment V2
GET
Get Event Database
GET
Get Feature Settings
GET
Get Federation Access Group
GET
Get Federation Access Group V2
GET
Get Gateway
GET
Get General Settings
GET
Get General Settings V2
GET
Get General Settings V3
GET
Get General Settings V4
GET
Get Global Policies
GET
Get GSSAPI Authenticator
GET
Get IC Domain Account
GET
Get IM Asset
GET
Get IM Stream
GET
Get IM Tag
GET
Get IM Version
GET
Get JWT Authenticator
GET
Get Local Access Group
GET
Get Local Access Group V2
GET
Get Message Client
GET
Get Permission
GET
Get Permission V2
GET
Get Preferences
GET
Get Preferences V2
GET
Get Pre Logon Settings
GET
Get RADIUS Authenticator
GET
Get Role
GET
Get SAML Authenticator
GET
Get Secondary Credentials
GET
Get Security Configuration Info
GET
Get Security Settings
GET
Get Security Settings V2
GET
Get Security Settings V3
GET
Get Security Settings V4
GET
Get Settings
GET
Get Settings V2
GET
Get Settings V3
GET
Get Settings V4
GET
Get Settings V5
POST
Get Storage Details
GET
Get Syslog
GET
Get True SSO Connector
GET
Get Unauthenticated Access User
GET
Get Users Or Group Local Summary V2
GET
Get Users Or Group Local Summary V3
GET
Get Users Or Groups Global Summary
GET
Get Virtual Center
GET
Get Virtual Center V4
GET
Get Virtual Center V5
POST
Import Certificate
GET
List App Volumes Managers
GET
List App Volumes Managers V2
GET
List Certificate Infos
GET
List Certificate Infos V2
GET
List Connection Servers
GET
List Connection Servers V2
GET
List Enrollment Servers
GET
List Federation Access Groups
GET
List Federation Access Groups V2
GET
List Gateway Access User Or Group
GET
List Gateways
GET
List GSSAPI Authenticators
GET
List IC Domain Accounts
GET
List IM Assets
GET
List IM Streams
GET
List IM Tags
GET
List IM Versions
GET
List JWT Authenticators
GET
List Licenses
GET
List Licenses V2
GET
List Local Access Groups
GET
List Local Access Groups V2
GET
List Log Collector Tasks
GET
List Message Clients
GET
List Permissions
GET
List Permissions V2
GET
List RADIUS Authenticators
GET
List RCX Servers
GET
List Roles
GET
List SAML Authenticators
GET
List Secondary Credentials
GET
List Selectable Privileges
GET
List True SSO Connectors
GET
List Unauthenticated Access Users
GET
List Users Or Groups Global Summary
GET
List Users Or Groups Local Summary
GET
List Users Or Groups Local Summary V2
GET
List Users Or Groups Local Summary V3
GET
List VC Info
GET
List VC Info V2
GET
List VC Info V3
GET
List VC Info V4
GET
List VC Info V5
POST
Mark Datastores For Archival
POST
Override Certificate
POST
Purge
POST
Push Certificates
POST
Recover Certificates
POST
Register Gateway
POST
Register RCX Client
DELETE
Remove Virtual Center
DELETE
Remove Virtual Center V5
POST
Reset Highest Usage Metrics
POST
Reset Named User Metrics
POST
Set License Key
POST
Set License Mode
POST
Unassign Farms
DELETE
Unregister Gateway
DELETE
Unregister RCX Client
PUT
Update Agent Restriction Settings
PUT
Update App Volumes Manager
PUT
Update App Volumes Manager V2
PUT
Update CEIP Info
PUT
Update Client Settings
PUT
Update Connection Server
PUT
Update Connection Server V2
PUT
Update Event Database
PUT
Update Feature Settings
PUT
Update General Settings
PUT
Update General Settings V2
PUT
Update General Settings V3
PUT
Update General Settings V4
PUT
Update Global Policies
PUT
Update GSSAPI Authenticator
PUT
Update IC Domain Account
PUT
Update IM Asset
PUT
Update IM Stream
PUT
Update IM Tag
PUT
Update IM Version
PUT
Update JWT Authenticator
PUT
Update Message Client
POST
Updatepassword
PUT
Update Preferences
PUT
Update Preferences V2
PUT
Update RADIUS Authenticator
PUT
Update RCX Client
PUT
Update Role
PUT
Update SAML Authenticator
PUT
Update Security Settings
PUT
Update Security Settings V3
PUT
Update Security Settings V4
PUT
Update Settings
PUT
Update Settings V2
PUT
Update Settings V3
PUT
Update Settings V4
PUT
Update Settings V5
PUT
Update Syslog
PUT
Update True SSO Connector
PUT
Update Virtual Center
PUT
Update Virtual Center V4
PUT
Update Virtual Center V5
POST
Validate AVM Certificate
POST
Validate SAML Certificate
POST
Validate Virtual Center Certificate