Update Security Settings

Update Security Settings

Updates the security 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.
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