The Kandji integration allows you to view device information about your users as you work with them in Foqal Agent web or Slack. Additionally, you can automatically kick off workflows and take actions on their devices automatically.

How to Install

Prerequisites

To install the Kandji integration, there are a few things you must ensure you have access to:

• Be an administrator in Foqal Agent.
• Be an administrator in Kandji.
• Have API access enabled in Kandji. This will automatically be enabled if you have more than 500 devices managed by Kandji or have used Kandji APIs in the past. If you are following the steps to set up your API key and do not see the right screens, you may not have access. Please reach out to your Kandji CSM for options and mention the Foqal Agent integration.

Getting an API Key

To install, you will first need to create an API token in Kandji. To do this, first, ensure you are logged in as an administrator in Kandji. Next, follow the steps to create a token::

1. Log into the Kandji portal as an administator.

2. Click on “⚙️ Settings” in the left tray

3. Select the Access Tab in the settings window.

4. At the bottom of this page, you should see a section called API Token. If you do not, please talk about your options with your Kandji CSM and mention the Foqal Agent integration.

5. Click Add Token then enter a name like “Foqal Agent” and any description you would like. Click Create.

6. Click Copy token and store that token a safe space. You will need this token when setting up the Kandji integration in Foqal Agent.

7. Acknowledge that you have copied the token and understand that you will not be able to see those details again. Now click Next.

8. On the Manage API Permissions screen, click Configure.

9. On the next screen, you will need to set permissions to give Foqal Agent access to Kandji. Click the checkbox next to Device Information and Device Actions. If you want a full itemized list of required scopes and what they are used for, please contact us. When you are done setting the scopes for Device Information and Device Actions, click Save.

Installing Kandji In Foqal Agent

To install the Kandji Integration, follow these steps:

1. You must be an administrator in Foqal Agent
2. Go to your Agent web interface and click on settings (⚙️ icon at the top right)
3. In the left tray under Automation, click Services.
4. From the list of services, click on Kandji and click Install on the right of the screen.
5. For the API Key, enter the API token you saved from the previous step 6 in Getting an API Key above.
6. Select your region (US or EU)
7. Enter your Kandji domain. This should look something like your-company.kandji.io
8. Click Install and you are done. 🙂