# Set up and install the ServiceNow Connector

> Set up and install the OneFuse ServiceNow Connector

---

Site [llms.txt](/llms.txt)

---

## Prerequisites

1. A ServiceNow instance. See [Supported Versions](/docs/onefuse/versions/compatibility/#vendors) for compatibility information.

2. A ServiceNow [MID Server](https://docs.servicenow.com/bundle/quebec-servicenow-platform/page/product/mid-server/concept/mid-server-landing.html) set up, installed, and configured. A ServiceNow user with the role `mid_server` must exist:

   1. Go to **User Administration** > **Users**.
   2. Create or edit a user.

      <div class="alert alert-info" role="alert">


      If creating a new user, save the user first before assigning roles.
      </div>


   3. Select **Roles** > **Edit**.
   4. Add `mid_server` to the **Roles List**.
   5. 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.

3. [Access the CloudBolt Download Article for CMP/OneFuse 2023.5](https://support.cloudbolt.io/cloudbolt/s/article/cloudbolt-2023-5--1983840286--1).

   <div class="alert alert-info" role="alert">


   The article always contains the latest OneFuse ServiceNow Connector download link.
   </div>


   1. Log in with your **CloudBolt Connect** account.
   2. Download the OneFuse ServiceNow Connector XML.

## Commit the ServiceNow Connector Update Set

1. Log in to your ServiceNow instance as an **Administrator**. The ServiceNow Administrator needs to perform Update Set Administration (see the steps below).
2. Go to **System Update Sets** > **Update Sets to Commit**.
3. Under **Related Links**, select **Import Update Set from XML**.
4. Select **Choose File** and select the ServiceNow Connector Update Set from your file system.
5. Select **Upload**.
6. **OneFuse Connector** (with a version number) will appear in the list.
7. Select **OneFuse Connector** in the list to view and edit the update set.
8. Select **Preview Update Set** in the top-right section of the browser.
9. When **Update Set Preview** shows "Succeeded 100%", select **Close**.
10. Select **Commit Update Set**.
11. When **Update Set Commit** shows "Succeeded 100%", select **Close**.
12. Select the **Back Arrow** to return to the list of Retrieved Update Sets.
13. **OneFuse Connector** will now show with **State: Committed**.
14. From the left navigation menu, searching for "onefuse" will show **OneFuse** > **OneFuse Instance**.

<div class="alert alert-warning" role="alert">


Ensure the Update Set version matches the OneFuse Instance version.
</div>


## Manage OneFuse Instance in ServiceNow

1. In ServiceNow, search in the left navigation menu for "onefuse".
2. Select **OneFuse** > **OneFuse Instance**.
3. In the top-left section of the menu, select **OneFuse Instances** > **New**.
4. 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. |

5. Select **Submit**.
6. The new OneFuse Instance will appear in the list of OneFuse Instances.

<div class="alert alert-warning" role="alert"><div class="h4 alert-heading" role="heading">Troubleshooting</div>


If you encounter an "Unable to validate OneFuse Connection" error, follow the steps in the ServiceNow KB article [MID Server connection failures](https://support.servicenow.com/kb?id=kb_article_view&sysparm_article=KB0864766).
</div>


## 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.

1. Go to **User Administration** > **Users**.
2. Create or edit a user.

   <div class="alert alert-info" role="alert">


   If creating a new user, save the user first before assigning roles.
   </div>


3. Select **Roles** > **Edit**.
4. Add `x_sovla_onefuse.admin` to the **Roles List**.
5. Select **Save**.
6. The role `x_sovla_onefuse.admin` will appear in the list.

## Next steps

Now that you have installed the OneFuse ServiceNow Connector Update Set, [create a ServiceNow Connector Policy](/docs/onefuse/configure/modules/servicenow-connector/catalog-item-policies/).