Get Security Settings

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

COPY

Authentication

This operation uses the following authentication methods.

Bearer

Responses

200

Returns SecuritySettings of type(s) */*

{
    "cluster_public_key": "3d43f005bfd5ade4c6853bd337f4d205e189c28793063087d1c0aeb58931e02c",
    "cluster_public_key_id": "cluster key",
    "data_recovery_password_configured": true,
    "message_security_mode": "ENABLED",
    "message_security_status": "NOTSET",
    "re_auth_secure_tunnel_after_interruption": true
}

string

cluster_public_key

Optional

The Base 64 encoded public key of the cluster in PEM format.

string

cluster_public_key_id

Optional

Key Id to identify the cluster's active key pair.

boolean

data_recovery_password_configured

Optional

Indicates whether the backup recovery password has been configured.

string

message_security_mode

Optional

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,

string

message_security_status

Optional

The status of the JMS message security. This tracks the application of changes to messageSecurityMode.

NOTSET: The cluster is performing at the specified message security mode.
ENHANCED: The Cluster is in Enhanced message security mode.
WAITING_FOR_BUS_RESTARTS: The cluster is waiting for the bus restart The cluster is waiting for a bus restart to transition to ENHANCED messagesecurity mode or from ENHANCED message security mode .
PENDING_ENHANCED: The cluster is propagating the change to ENHANCED message security mode to all nodes.
LEAVING_ENHANCED: The cluster is leaving the ENHANCED message security mode.
PREPARING_ENHANCED: The cluster is preparing to go in Enhanced mode.
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.

Possible values are : NOTSET, ENHANCED, WAITING_FOR_BUS_RESTARTS, PENDING_ENHANCED, LEAVING_ENHANCED, PREPARING_ENHANCED, DISABLED, MIXED, ENABLED,

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.

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

Description

Request

Authentication

Response

200 Response Body