AlienVault® USM Anywhere™

Notification Rules from the Orchestration Rules Page

Role Availability Read-Only Analyst   Manager

Notification rules are a mechanism to generate a specified notification method when the match criteria is met. One major difference between notification rules and other rules is that it does not have the mute operator available. These rules always generate a notification whenever the match criteria is met and never go silent.

You can create your own notificationCommunication of an important event, typically through an email message or other desktop display. In USM Appliance, notifications are typically triggered by events, policies, and correlation directives, and in USM Anywhere, they are typically triggered by notification rules or directly from alarms. rules from the Orchestration Rules page or from the EventsAny traffic or data exchange detected by AT&T Cybersecurity products through a sensor, or through external devices such as a firewall. details page, which is the easiest way to configure the matching conditions. See Creating Notification Rules from the Events Page for more information.

To create a notification rule from the Orchestration Rules page

  1. Go to Settings > Rules.
  2. Select Create Orchestration Rule > Create Notification Rule.

    Create a notification rule

  3. Enter a name for the rule.
  4. Select a notification method:
    • Amazon SNS: This requires the setup of the Amazon Simple Notification Service (SNS) API call from the USM Anywhere server. There is no limit to the number of SNS endpoint notifications sent; However, this method requires having an Amazon Web Services (AWS) account for setup and use. The Amazon SNS allows the first 1,000 email notifications per month to fall into the free messaging tier. See Amazon SNS pricing. See Sending Notifications Through Amazon SNS for more information.
    • Datadog: This requires the creation of a Datadog API key and additional steps. See Sending USM Anywhere Notifications to Datadog for more information.
    • Email: This method sends the notification by email. You need to enter information for the email subject and enter a destination email address. Multiple comma-separated email addresses are possible. This method uses a built-in integration to Amazon the SNS and Amazon Simple Email Service (SES) function. The only user-customizable information available is the email subject line.
    • Note: The emails are sent through Amazon SNS.

      Warning: There is a quota of 200 notifications every rolling 24-hour period. This quota refers to every email account. For example, you can have a rule with multiple emails, and in this case, it counts as a single email. Or you can have several rules with several emails, and in this case, it counts every email account. Keep in mind that sensor disconnect emails do not count against this number because they are critical. These emails only get sent out to users whose role is manager.

    • PagerDuty: This method is performed using an integration in the product, and the user setup is required. See Sending USM Anywhere Notifications to PagerDuty for more information.
    • Slack: This method makes use of a user created Slack Webhook integration. Slack integration can also be performed using Amazon SNS. See Sending USM Anywhere Notifications to Slack for more information.
  5. Click Add Condition and select the property values you want to include in the rule to create a matching condition.
  6. Note: Use the country code defined by the ISO 3166 if the field is related to the name of a country.

    Note: Keep in mind that the Sources or Destinations field needs to match the universally unique identifier (UUID) of the event or alarm. You can use the Source Name or Destination Name field instead.

  7. (Optional.) Click Add Group Of Conditions to group your conditions.
  8. Note: See Operators in the Orchestration Rules for more information.

  9. (Optional.) Click the More link to include a multiple occurrence parameter.

    These options function together to specify the number of occurrences within a time period that will produce a match for the rule. For example, you can define a rule to trigger an alarmAlarms provide notification of an event or sequence of events that require attention or investigation. for an unauthorized accessAn incident-type categorization that may be a precursor to other actions or stages of an attack. attempt when a failed SSHProgram to securely log into another computer over a network, to execute commands in a remote machine, and to move files from one machine to another through Secure Copy (SCP). loginLog in (verb): Process in which an individual gains access to a computer system after providing sufficient credentials to authenticate their unique identity. Login (noun): User credentials, typically a username and matching password. occurs three times within a five-minute window. You can modify these two options:

    • Occurrences: Specify the number of event occurrences that produce a match on the conditional expression to trigger the rule. Enter the number of occurrences or use the arrow to scroll the value up or down. You need to enter a number between 1 and 100.
    • Length: Specify the length of the window used to identify a match for multiple occurrences. Enter the number and choose a time-unit value of seconds, minutes, or hours.

      This duration identifies the amount of time that transpires from the first to last. If the number of occurrences is not met within this period, the rule is not a match.

      Specify multiple occurances to match for the rule

    In this example, the rule applies when the configured conditions happen five times every three hours.

  10. Click Save Rule.
  11. The created rule displays in the list of rules.

To filter notification rules by name

  1. Go to Settings > Rules.
  2. On the left navigation panel, click Notification Rules.
  3. Click the box next to Filter by.
  4. Enter your search.

To filter notification rules by rule status

  1. Go to Settings > Rules.
  2. On the left navigation panel, click Notification Rules.
  3. Click the combo box next to Rule Status.
  4. Select All Rules, Enabled, or Disabled.

To edit a notification rule

  1. Go to Settings > Rules.
  2. On the left navigation panel, click Notification Rules.
  3. Click the icon of the rule you want to edit.
  4. Modify the data of the items that need to be modified.
  5. Click Save Rule.

To delete a notification rule

  1. Go to Settings > Rules.
  2. On the left navigation panel, click Notification Rules.
  3. Click the icon of the rule you want to delete.
  4. Confirm by clicking Accept.

To enable a notification rule

  1. Go to Settings > Rules.
  2. On the left navigation panel, click Notification Rules.
  3. Click the icon of the rule you want to enable.

To disable an notification rule

  1. Go to Settings > Rules.
  2. On the left navigation panel, click Notification Rules.
  3. Click the icon of the rule you want to disable.

To enable all notification rules

  1. Go to Settings > Rules.
  2. On the left navigation panel, click Notification Rules.
  3. In the list of rules, select the first checkbox in the first column to select all the rules.
  4. Click Enable All Rules.

To disable all notification rules

  1. Go to Settings > Rules.
  2. On the left navigation panel, click Notification Rules.
  3. In the list of rules, select the first checkbox in the first column to select all the rules.
  4. Click Disable All Rules.
  5. Confirm by clicking Accept.