Setup

Connect Iru (Kandji) to Ravenna by creating an API token in the Iru dashboard and providing the token along with your Iru API URL during setup.

Connect to Iru using an API token

This guide walks you through creating an API token in Iru and connecting it to Ravenna for device management automation.

Prerequisites

Before you begin, ensure you have:

• Iru account with admin access
• Access to Iru dashboard settings
• Your Iru API URL

Setup guide

Create API token in Iru

1. Navigate to API settings

   1. Sign in to your Iru dashboard
   2. Navigate to Settings > Access (or API section)
2. Generate API token

   1. Find the API tokens section
   2. Click Create API Token or Generate Token
   3. Provide a descriptive name (e.g., “Ravenna Integration”)
   4. Select which APIs the token has access to. The minimum required permission for Ravenna is List Devices.
   5. Copy the generated token

   The API token is only shown once. Store it securely before closing the dialog.

3. Note your API URL

   Your Iru API URL is typically in the format: https://company.api.kandji.io

   Find this in your Iru dashboard settings or account information.

Add integration in Ravenna

1. Navigate to integrations

   1. Go to Settings > Integrations
   2. Find Iru in the Device Management section
2. Select Iru

   Click Connect on the Iru integration card

3. Configure credentials

   Provide the following information:

   apiUrl · string · required

   Your Iru API URL (e.g., https://company.api.kandji.io)

   Find this under Settings > Access in your Iru dashboard.

   apiToken · string · required

   The API token you generated in the previous step

4. Complete setup

   Click Connect to complete the integration. This will:

   1. Validate the API token
   2. Test connectivity to your Iru server
   3. Verify API permissions

Troubleshooting

Invalid API token error

Cause: API token is invalid, expired, or revoked

Solution:

• Verify the token was copied correctly (no extra spaces or characters)
• Check if the token still exists in Iru Settings > Access
• Generate a new API token if the current one is invalid
• Update the token in Ravenna integration settings

Invalid API URL error

Cause: API URL is incorrect or inaccessible

Solution:

• Verify the URL format matches your Iru instance (e.g., https://company.api.kandji.io)
• Ensure the URL includes the protocol (https://)
• Check that your Iru instance is accessible from your network
• Confirm the URL in your Iru dashboard settings

Connection timeout error

Cause: Cannot reach Iru API URL

Solution:

• Verify the API URL is correct and accessible
• Check if your Iru instance is behind a firewall
• Ensure network connectivity between Ravenna and Iru
• Verify DNS resolution for the API URL

Insufficient permissions error

Cause: API token doesn’t have required permissions

Solution:

• Verify the API token has appropriate read permissions for devices
• For workflow actions that modify devices, ensure write permissions are granted
• Regenerate the token with correct permissions in Iru settings

Device not found for user

Cause: Cannot match user to an Iru device

Solution:

• Verify the device is enrolled in Iru
• Check that user assignment information is populated on the device
• Ensure the user’s email matches the device assignment in Iru
• Confirm the device is active and reporting to Iru