ServiceNow

On this page

ServiceNow is an Issue Tracking output connector. Connect to your ServiceNow instance to open issues automatically.

IP Allowlists

You might need to add the Monad IP range of 34.210.32.104/32 to your ServiceNow allowlist, so Monad can connect to it.

ServiceNow is a ticketing system used in project management to communicate, triage and escalate issues. The Monad ServiceNow output connector uses a service account to file a daily ticket with the list of hostnames that have more than a certain threshold of vulnerabilities.

Note: The Monad ServiceNow output connector is in beta, currently reports only findings from Rapid7 InsightVm, and contains limited functionality that might change later. Have thoughts or ideas on how we could improve this connector? Let us know!

Create a Monad service user in ServiceNow

Before you connect ServiceNow as a Monad output, create a service user.

  1. Log in to ServiceNow with an account with user_admin permissions, so it can create new users.
  2. In the main menu, search for User Administration, and click Users.
  3. Click New.
  4. Enter a user ID and name for the service user. We recommend using something like monad_service and “Monad Service”.
  5. Enter a secure password, and save it to your password or secrets manager.
  6. Make sure that Password needs reset is deselected, and check the Web service access only box.
  7. Click Submit. ServiceNow creates the user and returns you to the user list.
  8. From the Users list, search for and click the service account you just created.
  9. Scroll to the bottom of the user profile and find the Roles tab, then click Edit.
  10. Search for and assign the new user the problem_coordinator role. This allows the user to create new Problem tickets. If you use a different table and role for the tracking you want Monad output into, select that role instead.
  11. Click Save.

Set up a ServiceNow output connector

To set up a ServiceNow connector, you need the following information:

  • the base url of your ServiceNow instance, including the https://
  • service account username
  • password

Once you have this information, you set up the connector:

  1. Log in to your Monad account, and click Add connector.
  2. Select the ServiceNow connector.
  3. Optionally, change the default name for the connector. This name serves as a label for the connector in the Monad app, and you can change it later.
  4. Enter the information for the ServiceNow service user, and click Connect.

That’s it! Monad tests the connection to ServiceNow, and if successful, prepares to create its first problem ticket.

Manually create a ServiceNow output ticket

You can manually trigger a ServiceNow output job once the connector is set up, by going to the connector detail page and clicking the gear icon, then Trigger data sync.

Content of a ServiceNow problem ticket

The ServiceNow output connector creates Problem tickets, with a basic subject line of You have (number) assets out of date, and a basic description containing the list of assets.

The list in the ticket contains all of the assets reported by InsightVM at the time the ticket was filed. This means that the (number) value is a running total of assets with issues at a specific point in time.

Monad creates a new once per day. You can also manually run the “create ticket” job from the Monad app.

This page was last modified: 8 Feb 2022