Iru (formerly Kandji)
Connect Iru (formerly Kandji) to Risotto to manage Apple devices directly from chat conversations
The Organization-wide integration between Risotto and Iru (formerly Kandji) provides access to workflow tools that let teams manage devices directly from chat conversations via Iru's MDM platform.
Prerequisites
To setup your integration, you will need:
- Access to your Kandji tenant
- The Org Admin or Manager role in Risotto
- Administrative privileges in Kandji to create and manage API tokens
- A generated API token from Kandji
- Your Kandji subdomain and region
Permissions Required
- Device List - View list of devices
- Get Device Details - View detailed device information
- List Audit Events - optional; required only for the Search Audit Events runbook tool
Setup
In the Kandji web console:
- Navigate to Settings > Access.
- Click Add API Token.
- Give it a descriptive name (e.g., "Risotto") and description, then click Create.
- Copy the API Token and store it securely — it cannot be viewed again after this step.
- Choose Configure permissions and enable the following:
- Device List - View list of devices
- Get Device Details - View detailed device information
- List Audit Events (under Audit Logs) - required only for the Search Audit Events runbook tool
- Click Save.
- Note your Kandji API URL shown in the Access settings (e.g.,
https://yourcompany.api.kandji.io). Your subdomain is the first part of the URL (yourcompany).
In Risotto:
Open the Iru integration
Go to Settings > Integrations and click the Iru card. On the API token card, click Connect.
Enter your Iru details
In the Iru dialog, fill in these fields, then click Save:
- Subdomain: your subdomain, for example
yourcompany. - API Token: the API token.
- Region: United States (US) or European Union (EU).
Risotto shows "Iru settings saved", and the API token card shows Connected with your subdomain and region.
- Subdomain: your subdomain, for example
Limitations
The Iru tools read devices and audit events, lock devices, and get device secrets. They cannot change device tags or other device settings. To change tags from a runbook, add the Iru API as a custom API source.
If you need additional assistance with this integration, contact your Risotto CSM.
Something wrong or missing? Report an issue · View as Markdown