You can determine the mapping of a field by adding the request in the condition of an orchestration rule. From an asset that has an assigned integration or from BlueApps, you can determine the mapping between the property value and its property key. Once you know the property key, you can add the field as a condition in your rule. To determine the mapping of a field from BlueApps
  1. Go to Data Sources > BlueApps > Available Apps.
  2. Locate the integration.
  3. Click the icon next to Data Sources Details.
  4. Search the property key inside the text box and copy the property value that maps with that property key.
    Note: In this example the field is “customfield_11“. This is only for this integration; the same field from another integration may be mapped to another field.
  5. Go to Settings > Rules.
  6. Select Create Orchestration Rule > Notification Rule.
  7. Select a Boolean operator. The options are AND, OR, AND NOT, and OR NOT.
  8. Select a packet type in the Match drop-down list.
    • Logs: Use this packet type for event-based rules.
    • Configuration Issues: Use this packet type for configuration issues-based rules.
    • Vulnerabilities: Use this packet type for vulnerabilities-based rules.
    • System Events: Use this packet type for system events-based rules.
    • Console User Events: Use this packet type for console user events-based rules.
    • Alarms: Use this packet type for console user alarms-based rules.
  9. Click Add Conditions and paste the property value.
  10. Choose an operator and enter the value.
    Note: The fields found in the integration code may be different from the fields used in the rule conditions. In the example, “customfield_11” is actually the “Custom Field 11” in rule conditions.
  11. (Optional.) Click Add Group to group your conditions.
    Note: See Operators in the Orchestration Rules for more information.
  12. In the Occurrences text box, enter the number of event occurrences that you want to produce a match on the conditional expression to trigger the rule. You can enter the number of occurrences or use the arrows to scroll the value up or down. You can enter a number between 1 and 100.
  13. Click Next.
    Important: A dialog box opens if there are warning messages. Click Cancel to review the warning messages, or click Accept to continue creating the rule.
  14. Enter a name for the rule.
  15. (Optional.) Enter a description for identifying this rule.
  16. Select a notification method:
    Note: The rolling 24-hour, 200-email limit refers to all email accounts. For example, you can have a rule with multiple emails, which counts as a single email delivery. Alternately, if you have several rules with several emails, each of these counts as an individual email account. Sensor-disconnect emails do not count against this number because they are critical and are only sent to users whose role is manager.
    Select the Sanitize Email Content checkbox to replace detailed email contents with a generic message and a link that requires user authentication to view further information.
    • PagerDuty: This method is performed using an integration in the product, and 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.
  17. In the Length text box, specify the timespan that you want to use to identify a match for multiple occurrences. Enter the number in the text box, and then use the drop-down menu to select a value of seconds, minutes, or hours. This duration identifies the amount of time that transpires from the beginning to the end of the occurrence. If the number of occurrences is not met within this period, the rule is not a match.
    Note: Your defined length and occurrences 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 for an attempt when a failed occurs three times within a five-minute window.
  18. Click Save. The created rule displays in the list of rules. You can see it from Settings > Rules. See Orchestration Rules for more information.
    Important: It takes a few minutes for an orchestration rule to become active.
To determine the mapping of a field from assets
  1. Go to Environment > Assets.
  2. Locate the asset that has the integration assigned.
  3. Next to the asset name, click the icon and select Full Details.
  4. Click the Assigned Apps tab.
  5. Click the icon next to Data Sources Details.
  6. Copy all the text under the Data pane.
  7. Search the property key inside the copied text and copy the property value that maps with that property key. For example, search the property key fromPort. This property key maps with customfield_11.
    Note: In this example the field is “customfield_11“. This is only for this integration; the same field from another integration may be mapped to another field.
  8. Go to Settings > Rules.
  9. Click Create Orchestration Rule > Notification Rules. See Notification Rules from the Orchestration Rules Page for more information.
  10. Select a Boolean operator. The options are AND, OR, AND NOT, and OR NOT.
  11. Select a packet type in the Match drop-down list.
    • Logs: Use this packet type for event-based rules.
    • Configuration Issues: Use this packet type for configuration issues-based rules.
    • Vulnerabilities: Use this packet type for vulnerabilities-based rules.
    • System Events: Use this packet type for system events-based rules.
    • Console User Events: Use this packet type for console user events-based rules.
    • Alarms: Use this packet type for console user alarms-based rules.
  12. Click Add Condition and paste the property value.
  13. Choose an operator and enter the value.
    Note: The fields found in the integration code may be different from the used in the rule conditions. In the example, “customfield_11“ is actually the “Custom Field 11“ in rule conditions.
  14. Click Next.
    Important: A dialog box opens if there are warning messages. Click Cancel to review the warning messages, or click Accept to continue creating the rule.
  15. Enter a name for the rule.
  16. (Optional.) Enter a description for identifying this rule.
  17. Select a notification method:
    Note: The rolling 24-hour, 200-email limit refers to all email accounts. For example, you can have a rule with multiple emails, which counts as a single email delivery. Alternately, if you have several rules with several emails, each of these counts as an individual email account. Sensor-disconnect emails do not count against this number because they are critical and are only sent to users whose role is manager.
    Select the Sanitize Email Content checkbox to replace detailed email contents with a generic message and a link that requires user authentication to view further information.
    • PagerDuty: This method is performed using an integration in the product, and 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.
  18. In the Length text box, specify the timespan that you want to use to identify a match for multiple occurrences. Enter the number in the text box, and then use the drop-down menu to select a value of seconds, minutes, or hours. This duration identifies the amount of time that transpires from the beginning to the end of the occurrence. If the number of occurrences is not met within this period, the rule is not a match.
    Note: Your defined length and occurrences 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 for an attempt when a failed occurs three times within a five-minute window.
  19. Click Save. The created rule displays in the list of rules. You can see it from Settings > Rules. See Orchestration Rules for more information.
    Important: It takes a few minutes for an orchestration rule to become active.