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

# ServiceNow

> How DSALTA integrates with ServiceNow — data collected, setup guide, and automated compliance checks.

## Overview

DSALTA connects to ServiceNow using read-only API access to collect compliance evidence automatically. Data syncs every 24 hours and feeds into your Data Library modules — account users for access reviews, plus ITSM incidents and change requests.

<Info>
  **Read-only access.** DSALTA never modifies, creates, or deletes resources in your ServiceNow instance.
</Info>

## How to Connect

ServiceNow connects over OAuth. Before you start, have your instance subdomain ready and sign in with a user that can read Users, Incidents, and Change Requests.

<Steps>
  <Step title="Have your instance subdomain ready">
    You'll enter your ServiceNow instance subdomain (for example, `dev12345` from `https://dev12345.service-now.com`) in the connect window.
  </Step>

  <Step title="Use a user with read roles">
    Connect with a ServiceNow user that can read Users, Incidents, and Change Requests — for example the `itil` role for incidents and changes plus a user-read role, or `admin`.
  </Step>

  <Step title="Connect">
    In the DSALTA sidebar, go to **Integrations**, find **ServiceNow**, and click **Connect**. Enter your instance subdomain and authorize read-only access in DSALTA's secure connection window.
  </Step>

  <Step title="Finish">
    DSALTA runs an initial sync — usually a few minutes — after which the compliance checks below activate.
  </Step>
</Steps>

## Automated Compliance Checks

Each check below runs automatically every 24 hours. Click any check for step-by-step remediation guidance.

| Check                                                                                                                     | Description                                                                           |
| ------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| [User access to Critical System should be valid](/integrations/servicenow/user-access-to-critical-system-should-be-valid) | Checks that everyone with ServiceNow access is an active employee on the People page. |
| [Offboarded users should not have active access](/integrations/servicenow/offboarded-users-should-not-have-active-access) | Checks that offboarded employees no longer have active ServiceNow access.             |

## Troubleshooting

<AccordionGroup>
  <Accordion title="Integration shows Disconnected">
    Re-authenticate from **Integrations → ServiceNow → Reconnect**. This can happen when the OAuth authorization is revoked or the connected user loses the roles needed to read Users, Incidents, and Change Requests.
  </Accordion>

  <Accordion title="Data is not syncing">
    Confirm the connected ServiceNow user still has read access to the Users, Incidents, and Change Requests tables (for example the `itil` role plus a user-read role, or `admin`), then trigger a manual sync from the integration settings.
  </Accordion>
</AccordionGroup>