> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oleria.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ServiceNow

> Install the Oleria update set in ServiceNow so Oleria can discover users, groups, and role assignments in your instance.

Connect ServiceNow to Oleria to see who has access to your ServiceNow instance and which roles they hold. Oleria generates an update set for your workspace, you import it into ServiceNow, and then Oleria connects to your instance.

## What Oleria discovers

* **Users** - accounts in your ServiceNow instance.
* **Groups** - ServiceNow groups and their membership.
* **Roles** - role assignments for each user, directly and through groups.
* **Resources** - tables, incidents, cases, and workflows, and the access control rules that grant roles access to them.
* **Activity** - event log activity such as sign-ins, sign-outs, impersonation, and table views.
* **Risks** - risks Oleria detects from your ServiceNow access data.

## Prerequisites

* A ServiceNow user who can elevate to the **admin** role.
* Admin access on the Oleria platform to add a new integration.

## Generate the update set in Oleria

<Steps>
  <Step title="Open the integration">
    Go to your Oleria workspace, select **Integrations** -> select **ServiceNow**.

    <img src="https://mintcdn.com/oleria/qn6A7RIhybLn0JXz/images/integrations/servicenow/step-11.png?fit=max&auto=format&n=qn6A7RIhybLn0JXz&q=85&s=8a8bee4faf53395c0c3427a877e47e6b" alt="Oleria Integrations page with the ServiceNow tile" width="872" height="327" data-path="images/integrations/servicenow/step-11.png" />
  </Step>

  <Step title="Enter your instance URL">
    Enter your ServiceNow URL in the **Instance URL** field, for example `https://instance-name.service-now.com`. Use the base URL only, with no path or query string.

    To let Oleria take [remediation actions](#remediation-actions), also select **I authorize Oleria to perform write actions in ServiceNow**. Oleria then includes the write permissions those actions need in the update set.

    Select **Continue**.

    <img src="https://mintcdn.com/oleria/qn6A7RIhybLn0JXz/images/integrations/servicenow/step-12.png?fit=max&auto=format&n=qn6A7RIhybLn0JXz&q=85&s=947ca5694dab7ecf659adbf2793e1e17" alt="Oleria ServiceNow connection form with the instance URL field" width="616" height="262" data-path="images/integrations/servicenow/step-12.png" />
  </Step>

  <Step title="Save the update set">
    Oleria shows an update set generated for your workspace under **Run the following in ServiceNow**. Copy its contents and save them as an XML file, for example `oleria-update-set.xml`. Keep the Oleria side panel open while you import the file into ServiceNow.
  </Step>
</Steps>

## Import the update set into ServiceNow

<Steps>
  <Step title="Elevate your role to admin">
    Sign in to your ServiceNow instance. Open your user menu, select **Elevate role**, select **admin**, and select **Update**.

    <img src="https://mintcdn.com/oleria/qn6A7RIhybLn0JXz/images/integrations/servicenow/step-1.png?fit=max&auto=format&n=qn6A7RIhybLn0JXz&q=85&s=94f2f7b4f477baa7f886a92535b9e728" alt="ServiceNow Elevate role dialog with the admin role selected" width="1151" height="539" data-path="images/integrations/servicenow/step-1.png" />
  </Step>

  <Step title="Open Retrieved Update Sets">
    Navigate to **All** -> search and select **Retrieved Update Sets**.

    <img src="https://mintcdn.com/oleria/qn6A7RIhybLn0JXz/images/integrations/servicenow/step-2.png?fit=max&auto=format&n=qn6A7RIhybLn0JXz&q=85&s=7cb5093085e041af82564ba84de8cb77" alt="ServiceNow All menu search results with Retrieved Update Sets" width="573" height="305" data-path="images/integrations/servicenow/step-2.png" />
  </Step>

  <Step title="Import the update set">
    Select **Import Update Set from XML**.

    <img src="https://mintcdn.com/oleria/qn6A7RIhybLn0JXz/images/integrations/servicenow/step-3.png?fit=max&auto=format&n=qn6A7RIhybLn0JXz&q=85&s=7114513da7d3e440e6eeba3be31b7487" alt="Retrieved Update Sets page with the Import Update Set from XML link" width="795" height="368" data-path="images/integrations/servicenow/step-3.png" />
  </Step>

  <Step title="Upload the Oleria update set">
    Select **Choose file**, choose the XML file you saved from Oleria, and select **Upload**.

    <img src="https://mintcdn.com/oleria/qn6A7RIhybLn0JXz/images/integrations/servicenow/step-4.png?fit=max&auto=format&n=qn6A7RIhybLn0JXz&q=85&s=199a2c3500ee2cd67bc4989c0379b3dd" alt="Import XML page with the Choose file and Upload buttons" width="760" height="312" data-path="images/integrations/servicenow/step-4.png" />
  </Step>

  <Step title="Select the uploaded update set">
    After a successful upload, ServiceNow returns you to the **Retrieved Update Sets** page. Select the Oleria update set you uploaded.

    <img src="https://mintcdn.com/oleria/qn6A7RIhybLn0JXz/images/integrations/servicenow/step-5.png?fit=max&auto=format&n=qn6A7RIhybLn0JXz&q=85&s=daef0fcf1a7b15a7d53897ec99cfdbc9" alt="ServiceNow Retrieved Update Sets page with uploaded Oleria update set listed" width="1323" height="397" data-path="images/integrations/servicenow/step-5.png" />
  </Step>

  <Step title="Preview the update set">
    Select **Preview Update Set**.

    <img src="https://mintcdn.com/oleria/qn6A7RIhybLn0JXz/images/integrations/servicenow/step-6.png?fit=max&auto=format&n=qn6A7RIhybLn0JXz&q=85&s=ac97710842344b53faa1780136f24027" alt="Oleria update set record with the Preview Update Set button" width="1225" height="336" data-path="images/integrations/servicenow/step-6.png" />
  </Step>

  <Step title="Confirm the preview">
    Confirm the preview runs without errors, then close the **Update Set Preview** window.

    <img src="https://mintcdn.com/oleria/qn6A7RIhybLn0JXz/images/integrations/servicenow/step-7.png?fit=max&auto=format&n=qn6A7RIhybLn0JXz&q=85&s=f9f9d1cf3d20b92de08d3262f10ae849" alt="ServiceNow Update Set Preview showing successful run with no errors" width="1195" height="337" data-path="images/integrations/servicenow/step-7.png" />
  </Step>

  <Step title="Commit the update set">
    Select **Commit Update Set** and confirm it completes without errors.

    <img src="https://mintcdn.com/oleria/qn6A7RIhybLn0JXz/images/integrations/servicenow/step-8.png?fit=max&auto=format&n=qn6A7RIhybLn0JXz&q=85&s=04d2b7d6be16817b8a1c71f713c19acb" alt="Oleria update set record with the Commit Update Set button" width="1097" height="483" data-path="images/integrations/servicenow/step-8.png" />
  </Step>

  <Step title="Verify customer updates">
    Open the committed update set and confirm the **Customer Updates** list isn't empty and has no entries in a collision or error state.

    <img src="https://mintcdn.com/oleria/qn6A7RIhybLn0JXz/images/integrations/servicenow/step-9.png?fit=max&auto=format&n=qn6A7RIhybLn0JXz&q=85&s=9902efcfea1d28645218a0be9fcc078e" alt="Oleria update set record showing its list of customer updates" width="920" height="514" data-path="images/integrations/servicenow/step-9.png" />

    <Note>If the **Customer Updates** list is empty or shows errors, contact us at [support@oleria.com](mailto:support@oleria.com) before you continue.</Note>
  </Step>

  <Step title="Confirm the commit">
    A successful commit shows a timestamp in the **Committed** column.

    <img src="https://mintcdn.com/oleria/qn6A7RIhybLn0JXz/images/integrations/servicenow/step-10.png?fit=max&auto=format&n=qn6A7RIhybLn0JXz&q=85&s=1d1c7a52b8ca68aff15a662f81f88ad4" alt="Retrieved Update Sets list with a timestamp in the Committed column for the Oleria update set" width="1250" height="402" data-path="images/integrations/servicenow/step-10.png" />
  </Step>
</Steps>

## Connect ServiceNow to Oleria

<Steps>
  <Step title="Confirm the import and authenticate">
    Return to the Oleria side panel. Select **I have run the above commands in ServiceNow**, then select **Authenticate**. Oleria validates the connection to your instance.
  </Step>
</Steps>

## Verify the integration

Confirm the ServiceNow instance appears on the **Connected** tab of your Oleria **Integrations** page with a status of **Healthy**. After the first sync completes, you can review the discovered users, groups, roles, resources, and activity in your Oleria workspace.

<img src="https://mintcdn.com/oleria/qn6A7RIhybLn0JXz/images/integrations/servicenow/step-13.png?fit=max&auto=format&n=qn6A7RIhybLn0JXz&q=85&s=1481161b30019f0ab44e3b7d95e21448" alt="Oleria workspace Connected Integrations showing newly added ServiceNow instance" width="1389" height="715" data-path="images/integrations/servicenow/step-13.png" />

## Remediation actions

If you selected **I authorize Oleria to perform write actions in ServiceNow** when you generated the update set, Oleria can take the following actions in ServiceNow:

* **Disable a user account**
* **Remove a user from a group**

## Contact us

For questions about this integration, contact us at [support@oleria.com](mailto:support@oleria.com).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.