About the ServiceNow Integration
The ServiceNow Integration in Iru Endpoint automatically pushes device inventory data from Iru Endpoint to ServiceNow in real-time, ensuring your device inventory in ServiceNow remains in sync with Iru Endpoint.How It Works
The ServiceNow integration creates a secure connection between Iru Endpoint and your ServiceNow instance, enabling automatic synchronization of Apple device inventory data. Authentication: The integration uses OAuth 2.0 authentication with a dedicated service account in ServiceNow to establish a secure API connection. Data Synchronization: Iru Endpoint automatically discovers all managed Apple devices and continuously syncs device information (serial numbers, model, OS version, user assignments) to ServiceNow’s asset management structure.Setup Overview
The following is a high-level overview of the integration setup process.1
Install ServiceNow App
Install the Iru Endpoint ServiceNow app in the ServiceNow integration hub.
2
Configure OAuth Client
Configure an OAuth client app so that Iru Endpoint can interact with the ServiceNow import set API.
3
Create ServiceNow User
Create a ServiceNow user account that can access the ServiceNow API.
4
Setup Integration in Iru Endpoint
Setup the ServiceNow integration in Iru Endpoint.
5
Complete Setup
Done
In order for the computer record in ServiceNow to be populated with the assigned user from Iru Endpoint, that user must already be registered in ServiceNow.
High-Level Data Flow
When a device enrolls into Iru Endpoint or a device record is modified, the following steps highlight the actions taken to push the changes to ServiceNow:1
Detect Changes
A change to Iru Endpoint device inventory is detected.
2
Push to Staging Tables
Iru Endpoint pushes these changes to ServiceNow staging tables via the ServiceNow Import Set API.
3
Transform Data
Once the import set flow is initiated, a transform map is used to match columns from the staging tables to columns in the target tables.
4
Update Records
ServiceNow then creates or updates device records in the ServiceNow computer table and Iru Endpoint MDM table accordingly.
Table Interactions
Iru Endpoint inserts device information into the ServiceNow tables below via the Import Set tables API.| Table | Description |
|---|---|
cmdb_ci_computers | Built-in ServiceNow table containing hardware information about devices. (Mac, iPhone, iPad, and tvOS). |
x_kandj_kandji_mdm | Custom table built by Iru Endpoint to store additional MDM related data about device assets. |
x_kandj_kandji_kandji_import_set_computer | Import set staging table used to stage device asset information before it is pushed to the cmdb_ci_computers table. |
x_kandj_kandji_kandji_import_set_mdm | Import set staging table used to stage MDM related device asset information be it is pushed to the x_kandj_kandji_mdm table. |
Iru Endpoint device attributes
Iru Endpoint sends the following device asset data to ServiceNow. Iru Endpoint will continue to add attributes to this list over time.Table: cmdb_ci_computers
| Iru Endpoint | ServiceNow | Description |
|---|---|---|
assigned_user | assigned_to | User assigned to the device asset |
device_capacity | disk_space | Total storage capacity |
device_name | name | Name of the device |
Discovery source | discovery_source | Constant value set to “Iru Endpoint” |
model_name | model | Device model name |
os_type | os | Operating system name macOS |
os_version | os_version | Operating system version |
serial_number | serial_number | Device serial number, also coalesces (refers back) to the computer table record in ServiceNow |
manufacturer | manufacturer | Constant value set to “Apple” |
Table: x_kandj_kandji_mdm
| Iru Endpoint | ServiceNow | Description |
|---|---|---|
device_id | name | Iru Endpoint device ID |
blueprint_id | name | Iru Endpoint blueprint ID, also coalesces (refers back) to the Iru Endpoint MDM table record in ServiceNow. |
serial_number | serial_number | Device serial number, also coalesces (refers back) to the computer table record in ServiceNow. |