Creating alerts
Alert definitions can include variables or performance indicators to determine when Application Security is to generate an alert notification in the Todo List pane of the Dashboard.
This functionality is available only if a Application Security Administrator has enabled email notifications.
You can configure alert notifications to send email messages about one or more alert notifications to users assigned to a given application version.
You can define alerts for any application versions to which you have been granted access.
To create a Application Security alert:
Sign in to Application Security as an Administrator.
On the header, select Administration.
On the navigation pane, expand Templates, and then select Alerts.
The Alerts page displays any defined alerts.
In the Alerts toolbar, click NEW.
In the Name box, type a name for the alert.
(Optional) In the Description box, type a description of the alert.
- To create the alert without enabling it, clear the Enable alert check box.
Next to Type, select the type of alert you want to create.
Only administrators can create scheduled alerts.
Next to Recipients, do one of the following:
- To have the alert sent only to you, leave the Me only option selected.
- To have the alert sent to users assigned to application version assignees, select the Version assignees option.
- (For scheduled alerts only) To have the alert sent to all Application Security users, select All system users.
Regardless of the option you select, you will receive the notification.
Provide the information for the alert type you selected, as described in the following table.
Alert type Instructions Performance indicator
From the Alert when list, select a performance indicator.
From the list of operators, select an operator.
Type a numeric value. The selected performance indicator type determines whether the value represents an integer or a percentage.
By default, performance indicator alerts are triggered just once, when the performance indicator value meets the criterion set for Alert when. For example, an alert with the trigger criterion set to Critical Exposure Issues < 50 is triggered only once, even if new critical issues are uncovered in subsequent scans.
- To have your alert reset after each new artifact upload, select the Reset after triggering check box.
Variable
From the Alert when list, select a variable.
From the list of operators, select an operator.
Type a numeric value. The selected variable type determines whether the value represents an integer or a percentage.
By default, variable alerts are triggered just once, when the variable value meets the criterion set for Alert when. For example, an alert with the trigger criterion set to
NEWIssues = 0is triggered only once, even if new issues are uncovered in subsequent scans.- To have your alert reset after each new artifact upload, select the Reset after triggering check box.
System event
From the Alert when list, select the system event to trigger the alert.
Scheduled alert (Administrators only)
From the Alert when date box, click to open a calendar and specify the date on which Application Security is to send the alert.
- Type the hour and minute (hh:mm) at which to send the alert.
- Click to toggle between AM and PM to set whether the alert is sent in the morning or afternoon.
- From the list of countries and regions, select the country or region to which your date and time settings apply.
- From the time zone list, select the time zone to which your time and date settings apply.
For a performance indicator or variable alert, do the following to specify the application versions to use for the alert:
Click ADD.
In the SELECT APPLICATION VERSION dialog box, from the APPLICATION list, select an application to use for the alert.
The VERSIONS pane lists the active versions of the selected application.
To include inactive versions of the application in the VERSIONS list, select the Show inactive check box.
To use the alert for all application versions, select the Select all check box. Otherwise, in the VERSIONS list, select the check boxes for the versions to use for the alert.
- To select versions of another application, repeat steps b through d.
Click DONE.
In the Message box, type a message to inform recipients why they have received the alert.
If you are creating a scheduled alert, message text is required.
Click SAVE.
See Also