Skip to main content

Iru (Kandji): How to connect to allwhere

Product Team
Updated

Before you get started

Please read our Iru (Kandji) Documentation to understand how the sync will work. Your Iru (Kandji) integration may create new employee records in allwhere. We recommend reading the linked documentation to ensure this does not happen. 

In order to connect allwhere to the Iru (Kandji) API you must first perform the following actions in your Iru (Kandji) console:

How to create Iru (Kandji) credentials

  1. In your Iru (Kandji) instance, navigate to Settings and click the Access tab.
  2. Click the + Add Token button to create a new token.
  3. Enter a display name for the token, we recommend naming this allwhere, and then click Create.
  4. Copy the generated API Token and store it in a safe place, as it is only shown once. You will need to provide this to allwhere.
  5. Next, click Configure on the token you just created to set its permissions.
  6. In the permissions list, under Device Information add
    1. Device details: /api/v1/devices/{device_id}/details
      GET: Get the full details for a specific device
    2. Device list: /api/vi/devices
      GET: Get a list of all devices in the Iru (Kandji) instance

      It will look like this: 

      image (8).png
  7. Click Save.

See Iru (Kandji) documentation here for additional support. 

Note: When creating your Iru (Kandji) API token, configure it with only the minimum required scopes to follow least-privilege best practices. Please use the kandji URL provided when you create the API token. 

How to add Iru (Kandji) credentials to allwhere

  1. In allwhere, click the Avatar Menu > Select "Integrations"

    Menu (4).png

  2. Click "Connect" next to Iru (Kandji)
  3. On the settings page enter the following values:
    1. Iru (Kandji) API Token
    2. Iru (Kandji) Instance URL
      Hint: You should enter your Kandji full URL here. It will be displayed when you create your token.
      US - https://SubDomain.api.kandji.io
      EU - https://SubDomain.api.eu.kandji.io


    3.  
  4. Click Connect account. Your sync will begin once we establish a connection.  

Ready to learn more? 

Click here to learn how the integration works

Disclaimer: 

Related articles