![dark-1.png]](https://support.senturo.com/hs-fs/hubfs/dark-1.png?height=40&name=dark-1.png){kind=small}
Incident IQ Integration
Manage and Recover Devices Directly from Incident IQ Asset Pages
Overview
The Incident IQ integration brings Senturo device management into the platform your team already works in. Once connected, every asset page in Incident IQ carries a set of Senturo action links that open the Senturo Device Console — an authenticated workspace scoped to that device.
From there, authorized users can review the device, trace its location history, check who has been signing in to it, escalate it to a recovery case, and run recovery actions. None of it requires leaving Incident IQ or holding a Senturo account.
This article explains how the integration works and what it makes available. The setup, administration, and usage guides are linked throughout.
How the Integration Works
The integration has four moving parts:
- A connection between the two platforms, established with an Incident IQ API token.
- Seven custom fields in Incident IQ, each of which renders one Senturo action link on asset pages.
- Per-user access, where each person is added individually, issued their own API key, and assigned specific permissions.
- A nightly sync, which keeps assets and their action links current.
Selecting any action link opens the Senturo Device Console for that asset. All seven links lead to the same place — once inside, users move between sections using the console's own navigation.
What You Can Do from Incident IQ
| Custom field | What it opens |
|---|---|
| Senturo: Location | Device location, coordinates, and location history |
| Senturo: Last Logged-In Users | The device user log |
| Senturo: Change Status | Setting the device to Monitored or Missing |
| Senturo: Lock Device | Applying a Senturo lock with a custom lock screen |
| Senturo: Unlock Device | Releasing a Senturo lock |
| Senturo: Wipe Device | Permanently erasing device data |
| Senturo: Generate Report | The Device Recovery Report |
The console also includes an Overview page summarising how the device is grouped, how frequently it checks in, the most recent administrative action taken on it, and the hardware and software it reports.
Access and Permissions
Access is granted per user, in Senturo. Each person added to the integration receives their own API key and a set of permissions covering the individual actions: View Location, View Users, Change Status, Lock Device, Unlock Device, Wipe Device, and Generate Report.
Users see only the sections they hold permissions for. Anything not granted does not appear in their navigation, which lets you keep destructive actions such as Wipe Device with senior staff while giving help desk technicians the read-only visibility they need.
Incident IQ users and Senturo users are managed separately. Someone can be granted Senturo actions in Incident IQ using their email address without ever becoming a full Senturo user — which suits roles that work entirely inside Incident IQ.
For the full administrator workflow, see Managing Users, Permissions, and API Keys in the Incident IQ Integration.
Device Status Controls the Recovery Actions
Every device is either Monitored or Missing.
Monitored is normal tracking. Missing enables heightened tracking, notifies administrators, and unlocks the three recovery actions: lock, wipe, and the recovery report. Those three are unavailable while a device is Monitored.
This makes marking a device Missing the first step in any recovery, rather than an optional extra. See Managing Device Status, Lock, and Wipe from Incident IQ.
Synchronization
Senturo syncs with Incident IQ nightly. Assets added to Incident IQ receive their Senturo action links on the next sync.
The initial sync runs once, when the custom field test first passes during setup. Its duration depends on how many assets you have, and Senturo emails you when it completes. Action links appear on asset pages at that point.
Platform Support
| Action | Supported platforms |
|---|---|
| View Location, View Users, Change Status, Generate Report | All platforms |
| Lock Device, Unlock Device | ChromeOS, macOS, Windows |
| Wipe Device | macOS, Windows |
Known Limitation
Because of a platform limitation in Incident IQ, Senturo action links open in the current browser tab rather than a new one. To keep your place in Incident IQ, right-click the action link and select Open Link in New Tab.
Setting Up and Managing the Integration
- How to Set Up Incident IQ Integration with Senturo — connecting the platforms, adding users, creating the seven custom fields, and testing the configuration.
- Managing Users, Permissions, and API Keys in the Incident IQ Integration — adding and removing users, assigning permissions, and generating, customising, and rotating API keys.
Using the Integration
- Accessing the Senturo Device Console from Incident IQ — finding the action links, authenticating, and navigating the console.
- Navigating the Senturo Device Console: Overview, Location, and Users — reading device details, location history, and login records, and exporting them.
- Managing Device Status, Lock, and Wipe from Incident IQ — escalating a device to Missing and running recovery actions.
- Generating a Device Recovery Report from Incident IQ — producing a complete record of a missing device for investigations and claims.
Troubleshooting
- Troubleshooting the Incident IQ Integration — connection failures, missing action links, sync delays, authentication problems, and actions that will not run.
Conclusion
The Incident IQ integration puts Senturo's device visibility and recovery tools on the asset pages your team already opens when a ticket comes in. A technician can locate a device, see who last used it, escalate it, and produce a report for the case file without switching platforms or holding a second set of credentials.
Configured with permissions that match each role, it gives your help desk what it needs to resolve device tickets quickly while keeping irreversible actions in the right hands.
FAQs
Q: Do users need a Senturo account to use Senturo actions in Incident IQ? A: No. A Senturo administrator can grant access using a person's email address. Incident IQ users and Senturo users are managed separately.
Q: How many custom fields does the integration require? A: Seven. Each one renders a single action link on the asset page, so all seven are needed for the complete set of actions.
Q: Can I restrict which actions a user can perform? A: Yes. Permissions are assigned individually per user, and users see only the sections they hold permissions for.
Q: Why are lock, wipe, and the recovery report unavailable on some devices? A: Those three require the device to be set to Missing. While a device is Monitored, they are disabled.
Q: How often does Senturo sync with Incident IQ? A: Nightly. Assets added to Incident IQ receive their Senturo action links on the next sync.
Q: What happens if a user's API key is lost or compromised? A: A Senturo administrator changes the key from the user's Edit Permissions panel. The previous key stops working immediately, and the user signs in again with the new one.