{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":46112,"path":"security-management/vulnerability-response/t_DefineNewIntegration.md","title":"Define a new vulnerability integration","bundle":null,"doc_type":null,"release":"australia","body":"\n# Define a new vulnerability integration\n\nA 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.\n\n## Before you begin\n\nPersona 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://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/security-management/vulnerability-response/vr-assign-personas_SA.md). For more information about managing granular roles, see [Manage persona and granular roles for Vulnerability Response](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/security-management/vulnerability-response/vr_manage_granular-roles.md).\n\nRole required: sn\\_vul.vulnerability\\_admin or sn\\_vul.admin \\(deprecated\\)\n\n## Procedure\n\n1. Navigate to **All** > **Vulnerability** > **Administration** > **Integrations**.\n\n2. Click **New**.\n\n3. Fill in the fields, as needed.\n\n\n
\n\nField\n\n\n\nDescription\n\n
\n\nName\n\n\n\nA descriptive name for the integration.\n\n
\n\nActive\n\n\n\nWhether 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.\n\n
\n\nRun\n\n\n\nThe 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.\n\n
\n\nDay\n\n\n\nThe day you want the integration to run.- If you selected **Weekly** in the **Run** field, this field displays the days of the week.\n- If you selected **Monthly** in the **Run** field, this field displays the days of the month.\n\n\n
\n\nTime\n\n\n\nThe time you want the integration to start. This field appears only if you selected **Daily**, **Weekly**, or **Monthly** in the **Run** field.\n\n
\n\nApplication\n\n\n\n\\[Read only\\] The name of the application for which this integration was created.\n\n
\n\nRepeat Interval\n\n\n\nIf you selected **Periodically** in the **Run** field, this field displays the number of days and hours before the integration runs again.\n\n
\n\nStarting\n\n\n\nIf you selected **Periodically** in the **Run** field, this field displays the dates and time to be used as the starting point for periodic updates.\n\n
\n\nConditional\n\n\n\nSelect this field if you want to add conditional parameters.\n\n
\n\nCondition\n\n\n\nIf you selected the **Conditional** check box, enter the conditions here.\n\n
\n\n**Integration Details**\n\n
\n\nIntegration script\n\n\n\nSelect 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.\n\n
\n\nIntegration factory script\n\n\n\nEnter a script that defines how to construct the script include selected for the **Integration script**. For more information, see [Integration factory script fields](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/security-management/vulnerability-response/c_AboutFactoryScript.md).**Note:** Scripts require both ServiceNow and Vulnerability Response expertise.\n\n
\n\nReport processor strategy\n\n\n\nSelect 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.\n- Select **Custom Report Processor** to select a custom processor.\n\n\n
\n\nReport processor\n\n\n\nIf 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.\n\n
\n\nProcessor factory script\n\n\n\nEnter a script that defines how to construct the script include selected for the **Report processor**.\n\n
4. Click **Submit**.\n\n\n**Related topics** \n\n\n[Vulnerability integration script](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/security-management/vulnerability-response/c_AboutVulnIntegScript.md)\n\n[Report processor strategies](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/security-management/vulnerability-response/c_AboutRptProcStrategies.md)\n\n[Integration factory script fields](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/security-management/vulnerability-response/c_AboutFactoryScript.md)\n\n[Manually run a vulnerability integration](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/security-management/vulnerability-response/t_ManualRunVulnInteg.md)\n\n"}}