Retrieve Details on MalOp Notification Settings

Endpoint URL: https://<your server/rest/settings/configurations
Endpoint URI: settings/configurations

Action: GET

Retrieves details on MalOp notification settings.

This API request is supported on versions 20.2.61 and higher.

Note

Ensure that you have logged into the Cybereason platform. For details, see Log in with the API.

Request Headers

You must add an Content-Type:application/json header with the request.

Note

If you are using cURL, add the authorization cookie details or the path to the file with cookie details with every request.


Request Body

None


Request Parameters

URL/URI parameters: None

Request Body Parameters: None


Response Success Schema

The response contains the following fields:

Field

Type

Description

outcome

String

The result of the retrieval operation.

data

Array

An object containing the details of all settings.

type

Enum

The type of setting about which you are retrieving information. For this response, the value of this field is PropertyConfiguration.

name

String

The specific setting about which you are retrieving details.

value

Array

The details on the settings. The fields inside this object differ per setting.

lastUpdate

Integer

The last time the setting was updated.


Response Failure Schema

None


Example: Retrieve setting details

Request

curl --request GET \
    --url https://12.34.56.78/rest/settings/configuration \
    --header 'Content-Type:text/plain' \

Response

{
  "outcome": "success",
  "data": [
      {
          "type": "PropertyConfiguration",
          "name": "scribe.archive.sensors.data.migration",
          "value": {
              "type": "ScribeArchiveSensorsMigrationConfig",
              "archiveDataMigrate": false
          },
          "lastUpdate": 1602525876869
      },
      {
          "type": "PropertyConfiguration",
          "name": "password.policy",
          "value": {
              "type": "PasswordPolicy",
              "passwordComplexity": "Basic",
              "passwordExpiration": 6,
              "lockoutPolicyEnabled": false,
              "failedLoginAttempts": 3,
              "failedLoginAttemptInterval": 3,
              "failedLoginLockReset": 60
          },
          "lastUpdate": 1602525305283
      },
      {
          "type": "PropertyConfiguration",
          "name": "custom.smtp",
          "value": {
              "type": "CustomSmtpServerConfig",
              "securityProtocol": "TLS",
              "host": null,
              "port": 0,
              "username": null,
              "password": null,
              "enabled": false
          },
          "lastUpdate": 1602525305283
      },
      {
          "type": "PropertyConfiguration",
          "name": "malop.notifications",
          "value": {
              "type": "malopNotificationConfig",
              "enabled": true,
              "frequency": "IMMEDIATE",
              "trigger": "CREATION",
              "malopTypes": []
          },
          "lastUpdate": 1603013427752
      },
      {
          "type": "PropertyConfiguration",
          "name": "sensor.statuses.policy",
          "value": {
              "type": "SensorStatusesPolicyConfig",
              "offlineToStaleInDays": 30,
              "staleNotificationsEnabled": true,
              "autoArchivingEnabled": true,
              "staleToArchivedInDays": 60,
              "autoArchivedNotificationsEnabled": true,
              "staleNotificationsFrequency": "WEEKLY"
          },
          "lastUpdate": 1602525305245
      },
      {
          "type": "PropertyConfiguration",
          "name": "login.enable.2fa",
          "value": {
              "type": "FeatureConfiguration",
              "enabled": false
          },
          "lastUpdate": 1602525305289
      },
      {
          "type": "PropertyConfiguration",
          "name": "duplicate.sensors.policy",
          "value": {
              "type": "FeatureConfiguration",
              "enabled": true
          },
          "lastUpdate": 1602525738912
      }
  ]
}