# Iru (formerly Kandji)

Connect Iru (formerly Kandji) to Risotto to manage Apple devices directly from chat conversations

> **Info:** **Iru is the new name for Kandji.** The product, API (`*.api.kandji.io`), and
> integration are the same — you may still see "Kandji" in some URLs and labels.

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](https://support.kandji.io/kb/kandji-api)
- 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](https://www.tryrisotto.com/docs/integrations/tools/kandji/search_audit_events) runbook tool

## Setup

In the Kandji web console:

1. Navigate to **Settings > Access**.
2. Click **Add API Token**.
3. Give it a descriptive name (e.g., "Risotto") and description, then click **Create**.
4. Copy the **API Token** and store it securely — it cannot be viewed again after this step.
5. 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](https://www.tryrisotto.com/docs/integrations/tools/kandji/search_audit_events) runbook tool
6. Click **Save**.
7. 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:

1. **Open the Iru integration**

   Go to **Settings > Integrations** and click the **Iru** card. On the **API token** card, click **Connect**.

   *Product example: Iru's integration page in Settings, not connected, with Connect on the API token card ringed.*

2. **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)**.

   *Product example: The Iru setup dialog filled in with Northwind's subdomain, an API token and the United States (US) region, with Save ringed.*

   Risotto shows "Iru settings saved", and the **API token** card shows **Connected** with your subdomain and region.

## 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](https://www.tryrisotto.com/docs/integrations/tools/custom-api-tools).

If you need additional assistance with this integration, contact your Risotto CSM.

Source: https://www.tryrisotto.com/docs/integrations/device-management/iru
