Set up the iru integration and get all the insights in Torii's dashboard
Overview
Torii integrates with iru and syncs:
| User Fields | License Types |
|---|---|
| Users | Mac |
| Licenses | iPhone |
| Status in app | iPad |
| Apple TV | |
| Windows | |
| Android |
Torii supports multiple iru accounts.
Additionally, iru discovers all installed apps on your company's devices as well as which users have these apps installed.
You will also be able to take and automate the following actions:
- Lock iru user's devices
- Erase iru user's devices
- Delete iru user's devices
Please note: we only display information on devices that are attributed to users.
You can constantly be updated with application information from our Integrations Page >> Integration Capabilities button >> Integration Capabilities table
Requirements
Accounts & permissions
- Make sure you have an iru account and an admin user with access to users and applications.
Scopes
- Torii requests the minimum required scopes to support syncing all required data.
- Torii requires the following scopes to sync full user and license data:
- Applications –
GET /api/v1/prism/apps - Device list –
GET /api/v1/devices
- Applications –
- To run actions in iru via Torii, additional permissions are required:
- "Read and take action" permissions when connecting the integration
- Lock iru user's devices:
POST /api/v1/devices/{device_id}/action/lockGET /api/v1/devices/{device_id}/secrets/unlockpin
- Erase iru user's devices:
POST /api/v1/devices/{device_id}/action/eraseGET /api/v1/devices/{device_id}/secrets/unlockpin
- Delete iru user's devices:
DELETE /api/v1/devices/{device_id}
Connect the iru Integration
- Generate an API token in iru by following the instructions in the official documentation:
https://support.kandji.io/kb/kandji-api - Once you have the API URL and API token, go to the Integrations page in Torii and select the iru tile.
-
Enter the API URL and API token, then click Connect.
-
Once the integration is connected and synced, it will display a green checkbox.
Q&A
Q: Are there any desktop apps that Torii does not discover that can be found in iru?
A: Torii discovers all desktop apps reported by iru with the exception of:
- Apps that include the word "helper"
- Apps that include the word "updater"
Q: I've run the "Lock iru user's devices" action. Where can I find the PIN?
A: After locking or erasing, the PIN number is available in the workflow action details.
Q: What happens if I run an iru action while the device is offline?
A: Lock and erase actions will be executed once the device reconnects to the internet. The delete action does not require connectivity to run, but the iru agent will only be removed once the device is back online.