Product documentation Docs
    • English
    • Deutsch
    • 日本語
    • 한국어
    • Français
  • More Sites
    • Now Community
    • Developer Site
    • Knowledge Base
    • Product Information
    • ServiceNow.com
    • Training
    • Customer Success Center
    • ServiceNow Support Videos
  • Log in

Product documentation

  • Home
How search works:
  • Punctuation and capital letters are ignored
  • Special characters like underscores (_) are removed
  • Known synonyms are applied
  • The most relevant topics (based on weighting and matching to search terms) are listed first in search results
Topics are ranked in search results by how closely they match your search terms
  • A match on the entire phrase you typed
  • A match on part of the phrase you typed
  • A match on ALL of the terms in the phrase you typed
  • A match on ANY of the terms in the phrase you typed

Note: Matches in titles are always highly ranked.

  • Release version
    Table of Contents
    • Security Operations
Table of Contents
Choose your release version
    Home Paris Security Incident Management Security Operations Vulnerability Response Vulnerability Response integrations Manually create a vulnerability integration Define a new vulnerability integration

    Define a new vulnerability integration

    • Save as PDF Selected topic Topic & subtopics All topics in contents
    • Unsubscribe Log in to subscribe to topics and get notified when content changes.
    • Share this page

    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

    Role required: v10.3 sn_vul.vulnerability.admin or sn_vul.admin (deprecated)

    Starting with v10.3, persona and granular roles are available to help you manage what users and groups can see and do in the Vulnerability Response application. For 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.

    Procedure

    1. Navigate to Vulnerability > Administration > Integrations.
    2. Click New.
    3. Fill in the fields, as needed.
      Table 1. Vulnerability integration
      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.
      Note: Scripts require both ServiceNow and Vulnerability Responseexpertise.
      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.
    4. Click Submit.
    Related tasks
    • Configure a vulnerability integration to use a scripted REST API
    • Manually run a vulnerability integration
    Related concepts
    • Vulnerability integration script
    • Report processor strategies
    • Integration factory script fields

    Tags:

    Feedback
    On this page

    Previous topic

    Next topic

    • Contact Us
    • Careers
    • Terms of Use
    • Privacy Statement
    • Sitemap
    • © ServiceNow. All rights reserved.

    Release version
    Choose your release version

      Define a new vulnerability integration

      • Save as PDF Selected topic Topic & subtopics All topics in contents
      • Unsubscribe Log in to subscribe to topics and get notified when content changes.
      • Share this page

      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

      Role required: v10.3 sn_vul.vulnerability.admin or sn_vul.admin (deprecated)

      Starting with v10.3, persona and granular roles are available to help you manage what users and groups can see and do in the Vulnerability Response application. For 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.

      Procedure

      1. Navigate to Vulnerability > Administration > Integrations.
      2. Click New.
      3. Fill in the fields, as needed.
        Table 1. Vulnerability integration
        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.
        Note: Scripts require both ServiceNow and Vulnerability Responseexpertise.
        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.
      4. Click Submit.
      Related tasks
      • Configure a vulnerability integration to use a scripted REST API
      • Manually run a vulnerability integration
      Related concepts
      • Vulnerability integration script
      • Report processor strategies
      • Integration factory script fields

      Tags:

      Feedback

          Share this page

          Got it! Feel free to add a comment
          To share your product suggestions, visit the Idea Portal.
          Please let us know how to improve this content

          Check any that apply

          To share your product suggestions, visit the Idea Portal.
          Confirm

          We were unable to find "Coaching" in Jakarta. Would you like to search instead?

          No Yes
          • Contact Us
          • Careers
          • Terms of Use
          • Privacy Statement
          • Sitemap
          • © ServiceNow. All rights reserved.

          Subscribe Subscribed Unsubscribe Last updated: Tags: January February March April May June July August September October November December No Results Found Versions Search preferences successfully updated My release version successfully updated My release version successfully deleted An error has occurred. Please try again later. You have been unsubscribed from all topics. You are now subscribed to and will receive notifications if any changes are made to this page. You have been unsubscribed from this content Thank you for your feedback. Form temporarily unavailable. Please try again or contact  docfeedback@servicenow.com  to submit your comments. The topic you requested does not exist in the release. You were redirected to a related topic instead. The available release versions for this topic are listed There is no specific version for this documentation. Explore products Click to go to the page. Release notes and upgrades Click to open the dropdown menu. Delete Remove No selected version Reset This field is required You are already subscribed to this topic Attach screenshot The file you uploaded exceeds the allowed file size of 20MB. Please try again with a smaller file. Please complete the reCAPTCHA step to attach a screenshot
          Log in to personalize your search results and subscribe to topics
          No, thanks Login