Get Global Configs

Gets every global config key and value applied across the system. Sensitive keys (SMTP password, LDAP bind password) are returned as ********.

Required Permissions

Requires the Master role.

HTTP Request

GET /api/sonar/global-configs
cURL Example
curl -H "Authorization: Bearer <API_KEY>" \
     https://HOSTNAME/api/sonar/global-configs

Success Response

{
  "global_configs": {
    "smtp_host": "smtp.example.com",
    "smtp_port": "25",
    "smtp_pass": "********",
    "ldap_host": "ldap.example.com",
    "ldap_bind_password": "********",
    "min_password_len": "8",
    "max_password_len": "64"
  }
}
  • global_configs (Map): Global config key/value pairs.

The global config keys are categorized as follows.

System
KeyDescription
api_keyAPI key
versionSystem version
web_endpointWeb console endpoint
experimentalWhether experimental features are enabled
browser_titleBrowser tab title
app_menu_pathApp menu path
app_menu_heightApp menu height
login_pathLogin page path
login_logo_widthLogin page logo width
login_logo_heightLogin page logo height
menu_logo_widthMenu logo width
menu_logo_heightMenu logo height
index_pathIndex path
Authentication and Session
KeyDescription
trust_host_countNumber of trusted hosts
block_concurrent_adminWhether concurrent admin login is blocked
block_concurrent_loginWhether concurrent user login is blocked
inactive_account_periodInactive account period (days)
min_password_lenMinimum password length
max_password_lenMaximum password length
password_complexityPassword complexity policy
LDAP
KeyDescription
ldap_hostLDAP server host
ldap_portLDAP server port
ldap_user_prefixUser DN prefix
ldap_user_suffixUser DN suffix
ldap_timeoutLDAP connection timeout (ms)
ldap_user_base_dnUser search base DN
ldap_bind_dnBind DN
ldap_bind_passwordBind password (masked in response)
ldap_user_search_filterUser search filter
external_auth_fail_policyPolicy on external authentication failure
SMTP
KeyDescription
smtp_hostSMTP server host
smtp_portSMTP server port
smtp_protocolSMTP protocol
smtp_userSMTP user account
smtp_passSMTP password (masked in response)
smtp_fromSender mail address
smtp_proxySMTP proxy configuration
ISAC
KeyDescription
isac_urlISAC service URL
isac_api_keyISAC API key
Explanation
KeyDescription
explanation_periodExplanation retention period
explanation_token_expiryExplanation token expiry
explanation_req_mail_ccCC recipients on explanation request mail
explanation_req_remindExplanation request reminder interval
explanation_url_aliasExplanation URL alias
explanation_submit_expiryExplanation submission deadline
explanation_requester_nameDisplay name of the explanation requester
max_explanation_log_countMaximum number of evidence logs
self_explanationWhether self-explanation is allowed
Asset IP
KeyDescription
ip_custom_fieldsAsset IP custom fields
ip_search_popupWhether the asset IP search popup is enabled
Lifecycle
KeyDescription
lifecycle_rollover_scheduleLifecycle rollover schedule
lifecycle_throttle_stepLifecycle processing step
Object Storage
KeyDescription
objectstorage_s3sdk_connection_timeoutS3 SDK connection timeout (ms)
objectstorage_s3sdk_minimum_throughput_timeoutS3 SDK minimum throughput timeout (ms)
objectstorage_s3sdk_target_throughput_in_gbpsS3 SDK target throughput (Gbps)
objectstorage_input_stream_buffer_size_in_bytesInput stream buffer size (bytes)
MITRE ATT&CK
KeyDescription
mitre_dashboard_highlight_timeMITRE dashboard highlight duration (ms)
Other
KeyDescription
use_auditor_tokenWhether the auditor token is used
use_ncsc_threatconWhether the cyber crisis alert level is used
ai_assistant_plainWhether AI assistant runs in plain mode
time_picker_default_hourDefault hour for the time picker
confirm_ticket_approve_status_changeWhether to confirm status change on ticket approval
table_usage_reload_intervalTable usage reload interval
behavior_profile_sync_max_jitterMaximum jitter for behavior profile sync
etir_ticket_score_thresholdE-TIR ticket score threshold
sso_hostsList of allowed SSO hosts
disk_usage_ignore_partitionsPartitions to exclude from disk usage calculation

Error Responses

Permission denied

HTTP status code 500

{
  "error_code": "illegal-state",
  "error_msg": "no-permission"
}