Define a new vulnerability integration
A vulnerability integration pulls report data from a third-party system, generally to retrieve vulnerability data, and process that reporting data using data sources or a custom processor.
Before you begin
Persona and granular roles are available to help you manage what users and groups can see and do in the Vulnerability Response application. For an initial assignment of the persona roles in Setup Assistant, see Assign the Vulnerability Response persona roles using Setup Assistant. For more information about managing granular roles, see Manage persona and granular roles for Vulnerability Response.
Role required: sn_vul.vulnerability_admin or sn_vul.admin (deprecated)
Procedure
Navigate to All > Vulnerability > Administration > Integrations.
Click New.
Fill in the fields, as needed.
| Field | Description |
|---|---|
| Name | A descriptive name for the integration. |
| Active | Whether the integration is active. If you do not want it to run for a specific time period, you can set up the parameters you want to use and deactivate the job. |
| Run | The frequency you want the integration to run, Daily, Weekly, Periodically, and so on. As noted, subsequent fields are displayed or not based on your setting in this field. |
| Day | The day you want the integration to run.- If you selected Weekly in the Run field, this field displays the days of the week. - If you selected Monthly in the Run field, this field displays the days of the month. |
| Time | The time you want the integration to start. This field appears only if you selected Daily, Weekly, or Monthly in the Run field. |
| Application | \[Read only\] The name of the application for which this integration was created. |
| Repeat Interval | If you selected Periodically in the Run field, this field displays the number of days and hours before the integration runs again. |
| Starting | If you selected Periodically in the Run field, this field displays the dates and time to be used as the starting point for periodic updates. |
| Conditional | Select this field if you want to add conditional parameters. |
| Condition | If you selected the Conditional check box, enter the conditions here. |
| Integration Details | |
| Integration script | Select the script include that extends the VulnerabilityIntegrationBase to be executed when the integration runs. This script defines how to retrieve data from a third-party system. |
| Integration factory script | Enter a script that defines how to construct the script include selected for the Integration script. For more information, see Integration factory script fields.Note: Scripts require both ServiceNow and Vulnerability Response expertise. |
| Report processor strategy | Select the strategy you want to use to handle the data returned by the integration script when the integration runs.- Select Data Source Attachment if you want to process data using a data source. - Select Custom Report Processor to select a custom processor. |
| Report processor | If you selected Custom Report Processor in the Report processor strategy field, select the script include that extends the VulnerabilityReportProcessorBase script include to be executed when the integration runs.This script defines how to process the data returned by the integration script. |
| Processor factory script | Enter a script that defines how to construct the script include selected for the Report processor. |
- Click Submit.
Related topics
Vulnerability integration script