Update Security Settings

Update Security Settings

All the listed privileges are required -

Privileges	Description
GLOBAL_CONFIG_MANAGEMENT	Caller should have permission to this privilege, to update settings.

Request

URI

PUT

https://{api_host}/rest/config/v1/settings/security

COPY

Request Body

SecuritySettingsUpdateSpec of type(s) application/json

Required

{
    "data_recovery_password_hash": [
        "5e884898da28047151d0e56f8dc6292773603d0d6aabbdd62a11ef721d1542d8"
    ],
    "data_recovery_password_hint": "password hint",
    "message_security_mode": "ENABLED",
    "re_auth_secure_tunnel_after_interruption": true
}

array of string

data_recovery_password_hash

Optional

The SHA-256 hash of the (UTF-8) data recovery password.

string

data_recovery_password_hint

Optional

The data recovery password hint. This property has a maximum length of 128 characters.

string

message_security_mode

Required

Determines if signing and verification of the JMS messages passed between Horizon components takes place.

DISABLED: Message security mode is disabled.
ENABLED: Message security mode is enabled. Unsigned messages are rejected by Horizon components.
ENHANCED: Message Security mode is Enhanced. Message signing and validation is performed based on the current Security Level and desktop Message Security mode.
MIXED: Message security mode is enabled but not enforced.

Possible values are : DISABLED, ENABLED, ENHANCED, MIXED,

boolean

re_auth_secure_tunnel_after_interruption

Optional

Determines if user credentials must be re-authenticated after a network interruption when Horizon clients use secure tunnel connections to Horizon resources. When you select this setting, if a secure tunnel connection ends during a session, Horizon Client requires the user to re-authenticate before reconnecting.

Authentication

This operation uses the following authentication methods.

Bearer

Responses

204

No Content

Operation doesn't return any data structure

400

Bad Request

Operation doesn't return any data structure

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

On This Page

Request

204 Response Body

Errors

Config Operations

Add App Volumes Manager

Add App Volumes Manager V2

Clear Event Database

Create Federation Access Group

Create Gateway Access User Or Group

Create GSSAPI Authenticator

Create IC Domain Account

Create IM Asset

Create IM Assets

Create IM Stream

Create IM Streams

Create IM Version

Create IM Versions

Create JWT Authenticator

Create Local Access Group

Create Message Client

Create Permissions

Create Permissions V2

Create RADIUS Authenticator

Create SAML Authenticator

Create Secondary Credential

Create True SSO Connector

Create Unauthenticated Access User

Create Virtual Center

Create Virtual Center V4

Create Virtual Center V5

Delete App Volumes Manager

Delete App Volumes Manager V2

Delete Certificate

Delete Federation Access Group

Delete Gateway Access User Or Group

Delete GSSAPI Authenticator

Delete IC Domain Account

Delete IM Asset

Delete IM Stream

Delete IM Version

Delete JWT Authenticator

Delete Local Access Group

Delete Message Client

Delete Permissions

Delete Permissions V2

Delete RADIUS Authenticator

Delete SAML Authenticator

Delete Secondary Credential

Delete True SSO Connector

Delete Unauthenticated Access User

Disable Connection Servers

Enable Connection Servers

Export Certificate

Get Admin Users Or Groups Permissions

Get AD Sites Info

Get Agent Restriction Settings

Get App Volumes Manager

Get App Volumes Manager V2

Get Client Settings

Get Connection Server

Get Connection Server V2

Get Enrollment Server

Get Environment

Get Environment V2

Get Event Database

Get Feature Settings

Get Federation Access Group

Get Federation Access Group V2

Get General Settings

Get General Settings V2

Get General Settings V3

Get General Settings V4

Get Global Policies

Get GSSAPI Authenticator

Get IC Domain Account

Get JWT Authenticator

Get Local Access Group

Get Local Access Group V2

Get Message Client

Get Permission V2

Get Preferences

Get Preferences V2

Get Pre Logon Settings

Get RADIUS Authenticator

Get SAML Authenticator

Get Secondary Credentials

Get Security Configuration Info

Get Security Settings

Get Security Settings V2

Get Security Settings V3

Get Security Settings V4

Get Settings V2

Get Settings V3

Get Settings V4

Get Settings V5

Get Storage Details

Get True SSO Connector

Get Unauthenticated Access User

Get Users Or Group Local Summary V2

Get Users Or Group Local Summary V3

Get Users Or Groups Global Summary

Get Virtual Center

Get Virtual Center V4

Get Virtual Center V5

Import Certificate

List App Volumes Managers

List App Volumes Managers V2

List Certificate Infos

List Certificate Infos V2

List Connection Servers

List Connection Servers V2

List Enrollment Servers

List Federation Access Groups

List Federation Access Groups V2

List Gateway Access User Or Group

List GSSAPI Authenticators

List IC Domain Accounts

List IM Streams

List IM Versions

List JWT Authenticators

List Licenses V2

List Local Access Groups

List Local Access Groups V2

List Log Collector Tasks

List Message Clients

List Permissions

List Permissions V2

List RADIUS Authenticators

List RCX Servers

List SAML Authenticators

List Secondary Credentials

List Selectable Privileges

List True SSO Connectors

List Unauthenticated Access Users

List Users Or Groups Global Summary

List Users Or Groups Local Summary

List Users Or Groups Local Summary V2

List Users Or Groups Local Summary V3

List VC Info V2

List VC Info V3

List VC Info V4

List VC Info V5

Mark Datastores For Archival

Override Certificate

Push Certificates

Recover Certificates

Register Gateway

Register RCX Client

Remove Virtual Center

Remove Virtual Center V5

Reset Highest Usage Metrics

Reset Named User Metrics

Set License Key

Set License Mode

Unregister Gateway

Unregister RCX Client

Update Agent Restriction Settings

Update App Volumes Manager

Update App Volumes Manager V2

Update CEIP Info

Update Client Settings

Update Connection Server

Update Connection Server V2

Update Event Database

Update Feature Settings

Update General Settings

Update General Settings V2

Update General Settings V3

Update General Settings V4

Update Global Policies

Update GSSAPI Authenticator

Update IC Domain Account

Update IM Asset

Update IM Stream

Update IM Version

Update JWT Authenticator

Update Message Client

Update Preferences

Update Preferences V2

Update RADIUS Authenticator

Update RCX Client

Update SAML Authenticator

Update Security Settings

Update Security Settings V3

Update Security Settings V4

Update Settings

Update Settings V2

Update Settings V3

Update Settings V4

Update Settings V5

Update True SSO Connector

Update Virtual Center

Update Virtual Center V4

Update Virtual Center V5

Validate AVM Certificate

Validate SAML Certificate

Validate Virtual Center Certificate