Set up and install the ServiceNow Connector
3 minute read
Prerequisites
-
A ServiceNow instance. See Supported Versions for compatibility information.
-
A ServiceNow MID Server set up, installed, and configured. A ServiceNow user with the role
mid_servermust exist:-
Go to User Administration > Users.
-
Create or edit a user.
If creating a new user, save the user first before assigning roles.
-
Select Roles > Edit.
-
Add
mid_serverto the Roles List. -
Select Save.
Verify that the MID Server has been successfully configured, that the MID Server service is started and running, and that the MID Server is validated with a status of Up in ServiceNow.
-
-
Access the CloudBolt Download Article for CMP/OneFuse 2023.5.
The article always contains the latest OneFuse ServiceNow Connector download link.
- Log in with your CloudBolt Connect account.
- Download the OneFuse ServiceNow Connector XML.
Commit the ServiceNow Connector Update Set
- Log in to your ServiceNow instance as an Administrator. The ServiceNow Administrator needs to perform Update Set Administration (see the steps below).
- Go to System Update Sets > Update Sets to Commit.
- Under Related Links, select Import Update Set from XML.
- Select Choose File and select the ServiceNow Connector Update Set from your file system.
- Select Upload.
- OneFuse Connector (with a version number) will appear in the list.
- Select OneFuse Connector in the list to view and edit the update set.
- Select Preview Update Set in the top-right section of the browser.
- When Update Set Preview shows “Succeeded 100%”, select Close.
- Select Commit Update Set.
- When Update Set Commit shows “Succeeded 100%”, select Close.
- Select the Back Arrow to return to the list of Retrieved Update Sets.
- OneFuse Connector will now show with State: Committed.
- From the left navigation menu, searching for “onefuse” will show OneFuse > OneFuse Instance.
Ensure the Update Set version matches the OneFuse Instance version.
Manage OneFuse Instance in ServiceNow
-
In ServiceNow, search in the left navigation menu for “onefuse”.
-
Select OneFuse > OneFuse Instance.
-
In the top-left section of the menu, select OneFuse Instances > New.
-
Fill out the fields:
Field name Notes Scheme Select whether the OneFuse instance is https or http. Host Enter the OneFuse host IP address or FQDN. Port Enter the OneFuse port number. OneFuse User Enter the OneFuse username that has the Workspace Admin or Workspace Member role. OneFuse Password Enter the OneFuse user’s password. MID Server Select the desired MID Server. -
Select Submit.
-
The new OneFuse Instance will appear in the list of OneFuse Instances.
If you encounter an “Unable to validate OneFuse Connection” error, follow the steps in the ServiceNow KB article MID Server connection failures.
Set up the ServiceNow OneFuse user
A ServiceNow user with the role x_sovla_onefuse.admin must exist. This user is used when creating a ServiceNow Endpoint.
-
Go to User Administration > Users.
-
Create or edit a user.
If creating a new user, save the user first before assigning roles.
-
Select Roles > Edit.
-
Add
x_sovla_onefuse.adminto the Roles List. -
Select Save.
-
The role
x_sovla_onefuse.adminwill appear in the list.
Next steps
Now that you have installed the OneFuse ServiceNow Connector Update Set, create a ServiceNow Connector Policy.