--- sourceDocument: Australia Security Management sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/security-management Release : - australia ft:locale : - en-US ft:publication_title : - Australia Security Management ft:clusterId : - security bundleId : - security workflow : - Technology --- # Define a new vulnerability integration # Define a new vulnerability integration {#ariaid-title1} * Release version: Australia * * Updated March 12, 2026 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read 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](https://servicenow-prod.fluidtopics.net/msi8kaFkGNjyRib_XBHEzQ "Assign the Vulnerability Response persona roles to groups or users with Setup Assistant."). For more information about managing granular roles, see [Manage persona and granular roles for Vulnerability Response](https://servicenow-prod.fluidtopics.net/WeKNf9YHNMJmJIA6yCsRvA "After you complete your initial assignment of persona roles using Setup Assistant, manage additional granular role assignments to users or groups from the User Administration module in your instance."). Role required: sn_vul.vulnerability_admin or sn_vul.admin (deprecated) ## Procedure 1. Navigate to AllVulnerabilityAdministrationIntegrations. 2. Click New. 3. Fill in the fields, as needed. {#t_DefineNewIntegration__table_s52_yvn_r5__entry__2} | 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. {#t_DefineNewIntegration__ul_kzb_ztt_25} | | 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](https://servicenow-prod.fluidtopics.net/yhS93aHfsjlN0Ii0NBCbFw "The Vulnerability Integration form contains the integration factory script and, when the Custom Report Processor report processor strategy is selected, the Processor factory script. These fields are used to provide the logic to actually instantiate the object defined by the script include reference fields, Integration script, and Report processor, respectively."). 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. {#t_DefineNewIntegration__ul_zww_twn_ht} | | 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. | [Table 1. Vulnerability integration] {#t_DefineNewIntegration__table_s52_yvn_r5} 4. Click Submit. **Related concepts** * [Vulnerability integration script](https://servicenow-prod.fluidtopics.net/Vx7cxl_IbDMzg9rpVrcc1Q "On the Vulnerability Integration form, the integration script is a reference to a script include that extends the VulnerabilityIntegrationBase script include.") * [Report processor strategies](https://servicenow-prod.fluidtopics.net/88BmkNd7MxOxofnna1HvoA "The Report processor strategy field on the Vulnerability Integration form is used to select the method to process the data returned by the vulnerability integration script when the vulnerability integration process is executed.") * [Integration factory script fields](https://servicenow-prod.fluidtopics.net/yhS93aHfsjlN0Ii0NBCbFw "The Vulnerability Integration form contains the integration factory script and, when the Custom Report Processor report processor strategy is selected, the Processor factory script. These fields are used to provide the logic to actually instantiate the object defined by the script include reference fields, Integration script, and Report processor, respectively.") **Related tasks** * [Manually run a vulnerability integration](https://servicenow-prod.fluidtopics.net/_hJ8ALYw3zMImlCnTZRkHw "Vulnerability integrations for Vulnerability Response and Application Vulnerability Response are configured to run on a scheduled basis. However, you can run them manually when needed.") *[\>]: and then