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}//localhost/rest/config/v1/settings/security

COPY

Request Body

Security settings object to be updated.

SecuritySettingsUpdateSpec of type(s) application/json

Required

{
    "data_recovery_password_hash": [
        "string"
    ],
    "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.
MIXED: Message security mode is enabled but not enforced.
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.

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

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