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 Orlando Security Incident Management Security Operations Vulnerability Response Vulnerability Response integrations Understanding the Rapid7 Vulnerability Integration Install and configure the Rapid7 Vulnerability Integration Create domain-separated imports for the Rapid7 vulnerability integration

    Create domain-separated imports for the Rapid7 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

    Create domain-separated imports for the Rapid7 vulnerability integration

    If you require vulnerability integration data to be imported to a specific domain, you must assign a user in that domain to run the integrations.

    Before you begin

    Role required: sn_vul.r7.admin and import_admin

    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.

    About this task

    This set of tasks require coding or advanced ServiceNow expertise.

    The import queues contain data attachments that the scheduled jobs (integrations) process. In a domain-separated environment, you must match the scheduled job with the correct import queue.

    Procedure

    1. Create a domain.
    2. For every domain you create, create a user and assign the user to that domain.
      Think of this user as a run_as placeholder for the domain in one of your Rapid7 vulnerability integrations. It is the equivalent to the VR.System user in the global domain. This user needs access to data sources, and vulnerability data.
      Note: Do not use this user for any other purpose.
    3. In each domain, create a scheduled job.
      1. Navigate to System Definition > Scheduled Jobs.
      2. Copy Scheduled Vulnerability Data Source Processor into the domain.
      3. To identify the scheduled job, append the domain to the name.
        Domain scheduled job form
      4. In the Run as field change the run_as user to the user you created in the Step 2.
    4. Ensure the integration runs in the run_as user domain.
      1. Edit the Execute Now UI action to add this code to the top of the file.
        //sys id below is of host detection integration
        if(current.sys_id == "5d9cf0daff540300c68c9f783894fa4d"){
        current.run_as = gs.getUserID
        ();
        }
        
      2. Edit the VulnerabilityIntegrationUtils script include method addIntegrationRun to add the highlighted code.
        addIntegrationRun script include method
      3. Add the highlighted code to the VulnerabilityIntegrationUtils script include method addProcessRun.
        addProcessRun code
        addProcessRun script include method
      4. Add the highlighted code to the VulnerabilityIntegrationUtils script include method copyProcess.
        copyProcess code
        copyProcess script include method
      5. Edit the DataSourceVulnReportRefreshProcessor script include method _processFromDataSourceGroups.
        Change the original line of code: this.integrationProcessGr.getUniqueValues()); to this.integrationProcessGr.getUniqueValue(),this.integrationProcessGr.getValue("sys_domain"));
        Edited _processFromDataSourcesGroups code
        Edited _processFromDataSourceGroups
      6. Add the following highlighted code blocks to the VulnerabilityDSAttachmentManager script include method, queueItem.
        queueItem
        queueItem function
      7. Add the following highlighted code blocks to the VulnerabilityDSAttachmentManager script include function, getNext.
        _getNext
        _getNext function
      8. Add the following highlighted code blocks to the VulnerabilityDSAttachmentManager script include function, _processQueueEntry.
        _processQueueEntry function
        processQueueEntry function
      At this point, you are ready for domain-separated host detection imports.
      Note: If you have multiple deployments of the Rapid7 InsightVM vulnerability integration, repeat this process for each deployment.

    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

      Create domain-separated imports for the Rapid7 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

      Create domain-separated imports for the Rapid7 vulnerability integration

      If you require vulnerability integration data to be imported to a specific domain, you must assign a user in that domain to run the integrations.

      Before you begin

      Role required: sn_vul.r7.admin and import_admin

      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.

      About this task

      This set of tasks require coding or advanced ServiceNow expertise.

      The import queues contain data attachments that the scheduled jobs (integrations) process. In a domain-separated environment, you must match the scheduled job with the correct import queue.

      Procedure

      1. Create a domain.
      2. For every domain you create, create a user and assign the user to that domain.
        Think of this user as a run_as placeholder for the domain in one of your Rapid7 vulnerability integrations. It is the equivalent to the VR.System user in the global domain. This user needs access to data sources, and vulnerability data.
        Note: Do not use this user for any other purpose.
      3. In each domain, create a scheduled job.
        1. Navigate to System Definition > Scheduled Jobs.
        2. Copy Scheduled Vulnerability Data Source Processor into the domain.
        3. To identify the scheduled job, append the domain to the name.
          Domain scheduled job form
        4. In the Run as field change the run_as user to the user you created in the Step 2.
      4. Ensure the integration runs in the run_as user domain.
        1. Edit the Execute Now UI action to add this code to the top of the file.
          //sys id below is of host detection integration
          if(current.sys_id == "5d9cf0daff540300c68c9f783894fa4d"){
          current.run_as = gs.getUserID
          ();
          }
          
        2. Edit the VulnerabilityIntegrationUtils script include method addIntegrationRun to add the highlighted code.
          addIntegrationRun script include method
        3. Add the highlighted code to the VulnerabilityIntegrationUtils script include method addProcessRun.
          addProcessRun code
          addProcessRun script include method
        4. Add the highlighted code to the VulnerabilityIntegrationUtils script include method copyProcess.
          copyProcess code
          copyProcess script include method
        5. Edit the DataSourceVulnReportRefreshProcessor script include method _processFromDataSourceGroups.
          Change the original line of code: this.integrationProcessGr.getUniqueValues()); to this.integrationProcessGr.getUniqueValue(),this.integrationProcessGr.getValue("sys_domain"));
          Edited _processFromDataSourcesGroups code
          Edited _processFromDataSourceGroups
        6. Add the following highlighted code blocks to the VulnerabilityDSAttachmentManager script include method, queueItem.
          queueItem
          queueItem function
        7. Add the following highlighted code blocks to the VulnerabilityDSAttachmentManager script include function, getNext.
          _getNext
          _getNext function
        8. Add the following highlighted code blocks to the VulnerabilityDSAttachmentManager script include function, _processQueueEntry.
          _processQueueEntry function
          processQueueEntry function
        At this point, you are ready for domain-separated host detection imports.
        Note: If you have multiple deployments of the Rapid7 InsightVM vulnerability integration, repeat this process for each deployment.

      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