ServiceNow

You can create, search, update, and manage ServiceNow incidents with the ServiceNow plugin for InsightConnect. Additionally, you can also use this plugin to monitor and process incident changes in a Rapid7 InsightConnect workflow.

To use the ServiceNow plugin, use an existing user account or create a dedicated user account to configure the connection in InsightConnect. For more information on the functionality of the ServiceNow plugin, see the Extension Library listing.

Create a user

  1. Log in to your ServiceNow instance with a user that has an admin role.
  2. Once logged in, select User Administration by typing it in the Filter navigator.
  3. Click Users > New.

ServiceNow User Administration

  1. Name your user in a way that indicates its purpose to help keep track of it, fill any other required fields, and click Submit.

Create a user

Assign a role

Different plugin actions require different permissions. For more information about permissions required and to find which role is needed for which action, please refer to the ServiceNow documentation.

  1. From the panel on the right side of your screen, click User Administration > Users. Open the newly created user record.

Select user

  1. In the Roles section, click Edit.

Edit roles

  1. From the Collection list, select the desired roles. Add them using arrows, and click Save.

Role selection

Configure the ServiceNow connection in InsightConnect

Now that you’ve created your user in ServiceNow, you can configure the ServiceNow connection in InsightConnect to use the plugin.

  1. In InsightConnect, open the connection configuration for the ServiceNow plugin.
    • You can do this when selecting the ServiceNow plugin during a workflow building session, or by creating the connection independently by choosing Plugins & Tools from the Settings tab on the left menu. On the Plugins & Tools page, select the Connections tab and click Add Connection in the upper-right corner.

Add connection in InsightConnect

  1. Configure the connection for the ServiceNow plugin.
    • Give the connection a unique and identifiable name, select the orchestrator the plugin should run on, and choose the ServiceNow plugin from the list. If it’s not available, import the plugin from the Installed Plugins tab.
  2. Configure your ServiceNow credentials.
    • In the credentials field, select existing ServiceNow credentials or enter a newly created username and password.
    • In the ServiceNow URL field enter the full URL to your instance of ServiceNow.

ServiceNow Connection

Test your connection

When you save the connection, the connection test will attempt to authenticate to the specified ServiceNow instance. A blue circle on the Connection tile indicates that the Connection test is in progress.

In Progress

Successful connection tests

If there is no circle, the connection succeeded and you're ready to begin orchestrating your processes with ServiceNow.

Success

Failed connection tests

A red circle indicates that the connection test failed. If this occurs, check your connection details (including the ServiceNow URL, username, and password) before trying again.

Failed

The log may contain useful troubleshooting information. First, click ​View​ to see a list of your recent connection tests.

View recent connection test

Under the Test Status​ tab, expand the dropdown for the test that encountered an error to view its log.

View security team log