Authentication
The Nucleus ServiceNow connector integrates directly with ServiceNow by leveraging a local account on the platform. A valid username and password is required for this integration, and authentication is achieved via Basic Auth.
In line with ServiceNow integration standards, the connector supports authentication using Basic Auth using a local service account. Authentication using OAuth 2 / SSO managed accounts is not supported.
Required Permissions
Your local account must have access to both of the permission sets below for each use case:
Connection Verification
- Read-only access to the sys_user table
Asset Inventory Synchronization
- Read-only access to any tables that contain ip or host_name for which asset inventory must be synchronised.
Since your ServiceNow implementation is specific to your organization, you’ll need to explicitly select the relevant table names to configure the automation rule. The available tables begin with cmdb_ci_. Nucleus recommends that you limit table access and only include relevant tables to speed up asset syncing.
Connector Setup Steps
-
In Nucleus go to Integration Hub > Connector Setup.
-
In the Asset Inventory or Issue Trackers sections, click the ServiceNow icon.
-
Choose the Setup ServiceNow Connector window and complete the following fields:
| Field | Info |
|---|---|
| ServiceNow URL | Enter the URL (including port number) of your ServiceNow Instance (or cloud URL). |
| Username | Enter the username you use to log into ServiceNow. |
| Password | Enter the password you use to log into ServiceNow. |
If you're using the Nucleus Agent to connect to an internal tool, please refer to the document here
-
Click the Save Changes button and wait for the Success message.
-
Click the Verify Connection button. You'll see a notification message confirming your successful connection test.
Syncing Custom Fields & Tables
In Nucleus, you can leverage the custom fields set up in ServiceNow for your assets and use them for various actions within Nucleus, such as asset processing rules or ticketing workflows. To enable this, you'll need to set up Nucleus to check for custom fields.
Set up Connector
In Tab 3 of the Connector Setup Page, you can enter in two advanced configuration options:
- Custom Tables - Enter in any custom tables that you've created within ServiceNow that you want to sync your asset information from.
- Custom Fields - Enter in the names of the custom fields you want to sync from ServiceNow that are stored in the same table as the asset information.
- For example, a ServiceNow field could be "active" or "business_criticality"
Make sure to Save the connector once you make these changes. The custom fields will import on the next sync from ServiceNow (which can be set up and configured in an Automation Rule).
Use in Automation Rules
Once the connector is set up, you'll need to make sure that your ServiceNow data has synced to Nucleus. Once the connector syncs again, the custom fields will be available for use in Nucleus.
The custom fields will populate in each asset's metadata, and each custom field can be used in various automation rules, including asset processing rules, asset sync rules for better organization, and asset grouping within Nucleus based on metadata from ServiceNow.