Connect to Iru using an API token
Prerequisites
Before you begin, ensure you have:- Organization admin access in Ravenna (only organization admins can open Settings > Integrations)
- 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
- Sign in to your Iru dashboard
- Navigate to Settings > Access (or API section)
2
Generate API token
- Find the API tokens section
- Click Create API Token or Generate Token
- Provide a descriptive name (e.g., “Ravenna Integration”)
- Select which APIs the token has access to. The minimum required permission for Ravenna is List Devices.
- Copy the generated token
3
Note your API URL
Your Iru API URL is typically in the format:
https://company.api.kandji.ioFind this in your Iru dashboard settings or account information.Add integration in Ravenna
1
Navigate to integrations
- Go to Settings > Integrations
- Find Iru in the Device Management section
2
Select Iru
Click Connect on the Iru integration card
3
4
Complete setup
Click Connect to complete the integration. This will:
- Validate the API token
- Test connectivity to your Iru server
- Verify API permissions
5
Turn on asset sync
- In Settings > Integrations, open Iru.
- Open the menu on the connection and select Configure.
- Under Sync scopes, add Asset, then save. Saving starts the first asset sync right away, unless the integration is paused. After that it runs every 6 hours.
Troubleshooting
Connected, but no devices in Assets
Connected, but no devices in Assets
Cause: Asset sync is off. It’s off by default, and connecting doesn’t turn it on.Solution:
- Open Iru in Settings > Integrations, select Configure on the connection, add Asset under Sync scopes, and save. Saving starts a sync right away, unless the integration is paused.
- If the devices appear in Settings > Organization - Assets but not in a workspace, link the synced asset types to that workspace. See Asset types.
Invalid API token error
Invalid API token error
Cause: API token is invalid, expired, or revokedSolution:
- 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
Invalid API URL error
Cause: API URL is incorrect or inaccessibleSolution:
- 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
Connection timeout error
Cause: Cannot reach Iru API URLSolution:
- 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
Insufficient permissions error
Cause: API token doesn’t have required permissionsSolution:
- 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
Device not found for user
Cause: Cannot match user to an Iru deviceSolution:
- 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