Overview
For customers moving from the previous model of (library-based only) alerting to the new Security Alerts: View By Vulnerability, this page describes the changes encountered.
GUI Changes
Reports
The following changes have been implemented to the Reports functionality:
Report | Changes |
---|---|
Alerts Report | Removed, and some of its functionality can be accessed through Security Alerts: View by Vulnerability. |
Ignored Alerts Report | Removed, and some of its functionality can be accessed through Security Alerts: View by Vulnerability. |
Risk Report | The Security panel has undergone name changes in some of its inner panels. |
Alerts Resolution Duration Report | Removed, and the Status column has been incorporated into the Licensing & Compliance Alerts and Security Alerts: View by Vulnerability. NOTE: Bulk actions of ignored/activated will be done only on items on which the action can be executed. |
Miscellaneous | Ignoring an alert now implements all its operations in the same screen (without moving the user to other screens). |
Dashboard
The following changes have been implemented to the dashboards:
Dashboard | Changes |
---|---|
Dashboard in Project/Product pages, Home Dashboard |
|
Security Trends |
|
Alert Emails
The following changes have been implemented for status updates containing new alerts emails:
- The section titles in email notifications have been changed from Security Library to Library Security Vulnerabilities.
- In each Library Security Vulnerabilities section, next to the library name, the total count of security vulnerabilities for the library is displayed.
- In each Library Security Vulnerabilities section, each vulnerability is displayed in a separate row along with its reported severity.
Prioritize
Grey shields are removed for displays that focus on vulnerabilities.
Policies
Grey shields (for customers with installations of Prioritize) are removed for displays that focus on vulnerabilities.
Library Details
The name of the Alerts panel has been changed, and its content now contains the Home dashboard categories for a library (those in Policy, Library, and Security).
API Changes
Modified APIs
The following is a list of APIs that have undergone changes if Vulnerability-based Alerting is enabled:
- getOrganizationAlerts
- getProductAlerts
- getProjectAlerts
- getOrganizationAlertsByType
- getProductAlertsByType
- getProjectAlertsByType
- getOrganizationIgnoredAlerts
- getProductIgnoredAlerts
- getProjectIgnoredAlerts
The changes are as follows:
- Previously, in the responses, the alert UUID was the same for all vulnerabilities related to the same library name. After enabling this feature, the alert UUID is unique per CVE and therefore different for all the vulnerabilities related to the same library.
- A new element has been added (sourceFiles) to the API response in case there is a relation between a CVE and a source file.
- The following fields were added to the responses of the APIs: getAlerts, getAlertsByProjectTag, getProjectAlertByType in all the scopes (project/product/organization):
- Modified Date
- Alert Status
- Comment
New APIs
The following is a list of new APIs that are only available to organizations if Vulnerability-based Alerting is installed:
APIs for generating security alerts reports, detailed by vulnerability
- getOrganizationSecurityAlertsByVulnerabilityReport
- getProductSecurityAlertsByVulnerabilityReport
- getProjectSecurityAlertsByVulnerabilityReport
APIs for generating security alerts reports, detailed by library
- getOrganizationSecurityAlertsByLibraryReport
- getProductSecurityAlertsByLibraryReport
- getProjectSecurityAlertsByLibraryReport
APIs for generating license and compliance alerts reports
- getOrganizationLicenseAndComplianceAlertReport
- getProductLicenseAndComplianceAlertReport
- getProjectLicenseAndComplianceAlertReport
For more details on these API calls, please refer to the API v3 documentation - HTTP API v1.3 (update in progress)
Removed APIs
Additionally, the following is a list of APIs that are not available to organizations if Vulnerability-based Alerting is installed:
- getOrganizationAlertsReport
- getProductAlertsReport
- getProjectAlertsReport
- getOrganizationIgnoredAlertsReport
- getProductIgnoredAlertsReport
- getProjectIgnoredAlertsReport
- getOrganizationResolvedAlertsReport
- getProductResolvedAlertsReport
- getProjectResolvedAlertsReport
Changes in the APIs do not cause any backward compatibility issues.
Unaffected APIs
For the remaining APIs that have not been affected by the transition to Vulnerability-based Alerting, see the following:
NOTE: In case there is a relation between a CVE and a source file, the following elements will be added to the API response:
//This is the new element that was added to the response in case the alerts relate to a source file "sourceFiles": [ { "name": "swagger-ui.min.js", "sha1": "0d1935e6d5d00a2c096989f5de2e08d8b2446d96", "systemPath": "dist/swagger-ui.min.js", "lastModified": "2019-08-28", "bytes": 0, "numOfLines": 0, "id": 6574351 } ]