Skip to main content

Objects

Notifications Visibility Options

You can use the visibilitySettings object to configure where notifications are visible. These are the available options:

Visibility option

Optional

Value

showInConsole

Yes

True to display this notification in Control Center, False otherwise. If no value is specified it will be set to its previous value or False if a aprevious value was not set.

sendPerEmail

Yes

True to send this notification by email, False otherwise. If no value is specified it will be set to its previous value or False if a previous value was not set.

This option will take effect only if a SMTP server is configured in the Configuration page of Control Center.

useCustomEmailDistribution

Yes

True to send email notification to a custom emailing list, False otherwise. The notification will be sent by email to the distribution list only.

If this option is set to True the sendPerEmail parameter must be specified and set to True.

If no value is specified it will be set to its previous value or False if a aprevious value was not set.

emails

Yes

(unless useCustomEmailDistribution exists and is set to True)

A list of email addresses to receive the notification via email. When set, only these email addresses receive the notification. When useCustomEmailDistribution is set to True, this list must contain at least one valid email address.

setCustomEmailSubject

Yes

Boolean, if True, default notification email subject lines will contain the text from the emailSubject field. If False, the default email subject line will be used.

Note

This option is only available for the 1,12, 16, 17, 21, 18, 19, 20, 22, 23, 25, 26, 29, and 31 notification types.

emailSubject

Yes

(unless setCustomEmailSubject exists and is set to True)

String, contains the custom text to be used as a subject line for notification emails.

Note

This option is only available for the 1,12, 16, 17, 21, 18, 19, 20, 22, 23, 25, 26, 29, and 31 notification types.

  • At least one visibility option from showInConsole, sendPerEmail must be set to True when the notification is enabled.

  • The sendPerEmail, useCustomEmailDistribution and emails visibility options are not available for these notification types:

    • 22 - Product Modules Event

Relation Between Notification Type and configurationSettings

Notification type

Available configurationSettings items with their type and possible values

1 - Malware Outbreak

  • useThreshold, boolean, True to trigger this notification when the number of infected managed network objects exceeds a custom threshold, False otherwise

  • threshold, integer, the percentage of managed network objects infected by the same malware. Valid values are between 1 and 100

2 - License Expires

The configurationSettings parameter should not be set for this notification.

3 - License Usage Limit Has Been Reached

  • receiveForChildCompany, boolean, True to receive the notification for a child company, False otherwise

  • triggerSettings, integer, the license status which triggers this notification. Set to 1 for Exceeded, or 2 for Reached and exceeded

4 - License Limit Is About To Be Reached

The configurationSettings parameter should not be set for this notification.

5 - Update Available

  • showConsoleUpdate, boolean, True to receive the notification for console updates, False otherwise

  • showPackageUpdate, boolean, True to receive the notification for package updates, False otherwise

  • showProductUpdate, boolean, True to receive the notification for product updates, False otherwise

9 - Exchange License Usage Limit Has Been Reached

The configurationSettings parameter should not be set for this notification.

10 - Invalid Exchange User Credentials

The configurationSettings parameter should not be set for this notification.

11 - Upgrade Status

The configurationSettings parameter should not be set for this notification.

13 - Authentication Audit

The configurationSettings parameter should not be set for this notification.

17 - Antipshising Event

The configurationSettings parameter should not be set for this notification.

18 - Firewall Event

The configurationSettings parameter should not be set for this notification.

19 - ATC/IDS event

The configurationSettings parameter should not be set for this notification.

20 - User Control Event

The configurationSettings parameter should not be set for this notification.

21 - Data Protection Event

The configurationSettings parameter should not be set for this notification.

22 - Product Modules Event

  • receiveForChildCompany, boolean, True to receive the notification for a child company, False otherwise

23 - Security Server Status Event

  • notUpdated, boolean, True to receive the notification when the Security Server is outdated, False otherwise

  • reboot, boolean, True to receive the notification when the Security Server needs a reboot, False otherwise

24 - Product Registration Event

The configurationSettings parameter should not be set for this notification.

24 - Product Registration Event

  • receiveForChildCompany, boolean, True to receive the notification for a child company, False otherwise

25 - Overloaded Security Server Event

  • useThreshold, boolean, True to receive the notification when the scan load exceeds a custom threshold, False otherwise

  • threshold, integer, the minimum scan load necessary to issue this notification. Valid values are between 1 and 100

26 - Task Status

  • statusThreshold, integer, the task status which triggers this notification. Set to 2 for any status, 3 for failed tasks

27 - Outdated Update Server

The  configurationSettings parameter should not be set for this notification.

32 - Amazon EC2 trial expires in 7 days

The configurationSettings parameter should not be set for this notification.

33 - Amazon EC2 trial expires tomorrow

The configurationSettings parameter should not be set for this notification.

34 - Amazon EC2 subscription activated

The configurationSettings parameter should not be set for this notification.

35 - Amazon EC2 subscription canceled

The configurationSettings parameter should not be set for this notification.

36 - Invalid Amazon EC2 credentials

The configurationSettings parameter should not be set for this notification.

39 - Notification_Type_Troubleshooting_Activity

  • receiveForChildCompany, boolean, True to receive the notification for a child company, False otherwise

40 - Notification_Type_Investigation_Files

  • investigationPackagesDownloads, boolean, True to receive notifications for down loading an Investigation Package.

  • remoteShellDownloads, boolean, True to receive notifications for downloading a file while connected through Remote Shell.

  • remoteShellUploads, boolean, True to receive notifications for uploading a file while connected through Remote Shell.

41 - Notification_Type_Sensor_Integration_Status

  • receiveForChildCompany, boolean, True to receive the notification for a child company, False otherwise

  • useThreshold, boolean, True to enable using a custom treshold.

  • threshold, integer, this option sets a minimum time period (in minutes) between Sensor Integration Status notifications related to a specific event type.

    Possible values: 30 - 240.

    Default value: 120.

42 - Amazon EC2 trial started

The configurationSettings parameter should not be set for this notification.

43 - Amazon EC2 subscription type has changed

The configurationSettings parameter should not be set for this notification.