> ## Documentation Index
> Fetch the complete documentation index at: https://docs.threataware.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Kandji

> Connect ThreatAware to Kandji

## Overview

The Kandji integration enables ThreatAware to collect data from your Kandji system.

<Info>
  **Connection Method**: API
  **Setup Time**: 15 minutes
  **Access Required**: Administrator account
</Info>

## Setup instructions

<Steps>
  <Step title="Log in to Kandji Admin Console">
    * Access the [Kandji Admin Console](https://app.kandji.io) using an account with administrator privileges.
  </Step>

  <Step title="Generate an API Token">
    * In the Kandji console, navigate to **Settings** > **Access Tokens**.
    * Click **Create New Token** to generate an API token for ThreatAware integration.
    * Set the permissions required for ThreatAware, typically **Read-only** for monitoring, or adjust based on integration needs.
    * Copy the **API Token** once it is generated.
  </Step>

  <Step title="Input API Token in ThreatAware">
    * Open ThreatAware, go to **Integrations**, and select **Kandji**.
    * Paste the **API Token** and **Kandji URL** into their respective fields.
  </Step>
</Steps>

## Input details

<AccordionGroup>
  <Accordion title="API Token" icon="key">
    Token generated for API access in Kandji.

    ```text theme={null}
    Field: API Token
    Name: Kandji API Token
    Type: Password
    ```
  </Accordion>

  <Accordion title="Kandji URL" icon="key">
    URL of the Kandji instance.

    ```text theme={null}
    Field: Kandji URL
    Name: Kandji URL
    Type: String
    Placeholder: "https://app.kandji.io"
    ```
  </Accordion>
</AccordionGroup>

## Verification and troubleshooting

<AccordionGroup>
  <Accordion title="Verification" icon="triangle-exclamation">
    After entering the API credentials, confirm that the **Integration Status** in ThreatAware shows as **Active**.
  </Accordion>

  <Accordion title="Troubleshooting" icon="triangle-exclamation">
    * **Invalid API Token**: Double-check the **API Token** entry for accuracy.
    * **Permission Denied**: Verify that the token has the necessary permissions for ThreatAware’s access in Kandji.
  </Accordion>
</AccordionGroup>

## Important notes and links

* Refer to the [Kandji API Documentation](https://developer.kandji.io/) for detailed permissions and API setup.
* API tokens should be securely stored, as they provide access to Kandji’s management data.