# Kandji (nu Iru)

> Verbind je Kandji-omgeving, nu Iru, met Tidal Control via een alleen-lezen API-token, zodat compliancetests de versleuteling van je Macs uitlezen. Alleen lezen.

Source: https://tidalcontrol.com/nl/docs/integrations/kandji

De Kandji-integratie van Tidal Control leest de status van je apparaten uit je Kandji-omgeving voor compliancedoeleinden. Kandji heeft in oktober 2025 de naam **Iru** gekregen; het platform en de API zijn onveranderd, en de integratietegel in Tidal Control heet nog steeds **Kandji**. De verbinding authenticeert met een API-token tegen je eigen Kandji API-URL en levert het bewijs waar auditors om vragen bij versleuteling van endpoints en mobile device management.

## Wat deze integratie monitort

- **FileVault-versleuteling:** Of volledige schijfversleuteling aanstaat op elke Mac
- **Versleuteling van het datavolume:** Of het datavolume zelf versleuteld is
- **MDM-inschrijving:** Of elk apparaat nog actief is ingeschreven
- **Supervisie van apparaten:** Of apparaten onder supervisie staan
- **Recovery Lock:** Of recovery lock is ingesteld

## Vereisten

- De rol Super User in Tidal Control
- Een Kandji-omgeving en rechten om API-tokens te beheren
- De **API-URL** van je omgeving, die per omgeving verschilt

## Stappenplan voor de configuratie

We zoeken de **API-URL** van je omgeving op, maken een **API-token** aan en voegen daarna de verbinding toe in Tidal Control.

**Configuratiestappen:**

1. **Zoek je API-URL op**
2. **Maak een API-token aan**
3. **Configureer de integratie in Tidal Control**

## Stap 1: Zoek je API-URL op

- Log in op je Kandji-omgeving
- Ga naar **Settings → Access → API Token**
- Kopieer de **API-URL** die daar staat. Die is specifiek voor jouw omgeving en ziet uit als `https://jouwomgeving.api.kandji.io`

> **warning:**

**De API-URL moet het schema bevatten.** Tidal Control weigert een waarde die niet met `http` begint, dus vul de volledige `https://...`-URL in en niet alleen een hostnaam.

## Stap 2: Maak een API-token aan

- Voeg op dezelfde pagina **Settings → Access** een nieuwe **API Token** toe
- Ken de leesrechten op apparaten toe, zodat de token apparaten en hun details kan opvragen
- **Kopieer de token direct**: Kandji laat hem maar één keer zien

## Stap 3: Configureer de integratie in Tidal Control

- Ga naar **Instellingen → Integraties** in Tidal Control
- Klik op het **plusicoon** naast **Kandji**
- Vul de configuratie in:
  - **Naam:** Een beschrijvende naam, bijvoorbeeld `Kandji`
  - **API-URL:** De URL van je omgeving uit stap 1
  - **API-sleutel:** De token uit stap 2
- Klik op **"Aanmaken"** om de integratie op te slaan

## Configuratievelden uitgelegd

Het configuratievenster vraagt om de volgende waarden:

**Naam:**
- Een beschrijvende naam voor deze verbinding
- Bijvoorbeeld: `Kandji`

**API-URL:**
- De Kandji API-URL van je omgeving, inclusief `https://`
- Verplicht

**API-sleutel:**
- De API-token uit stap 2
- Verplicht, en wordt als secret opgeslagen

## Verificatie

De integratie werkt wanneer al het volgende waar is:

- Instellingen → Integraties toont Kandji onder **Geconfigureerde integraties**
- De Kandji-tests zijn beschikbaar in de sectie Tests
- Het verversen van tests levert apparaatresultaten zonder authenticatiefouten

## Veelgestelde vragen

**Waarom is de API-URL per omgeving anders?**
Kandji host elke omgeving op een eigen subdomein, dus er is geen gedeelde standaardhost om op terug te vallen. Je moet die van jou uit de omgeving kopiëren.

**Dekt dit ook andere apparaten dan Macs?**
De controles dekken de Apple-apparaten die Kandji beheert. Apparaten die Kandji niet beheert kunnen niet verschijnen, dus beschouw de dekking van Kandji als onderdeel van je apparaatinventaris.

**Leest Tidal Control iets van de apparaten zelf?**
Nee. De integratie leest apparaatrecords uit de Kandji-API, die de beheerstatus rapporteert en niet de bestanden van gebruikers.

## Veelvoorkomende problemen

**"API URL is required" of "API URL must start with http"**
- Vul de volledige URL inclusief schema in, bijvoorbeeld `https://jouwomgeving.api.kandji.io`

**"API Key is required"**
- De token is niet geplakt, of na het aanmaken verloren gegaan. Maak een nieuwe token aan in Kandji

**Apparaatcontroles leveren geen apparaten op**
- De token mist leesrechten op apparaten, of de API-URL verwijst naar een andere omgeving

### Kom je er niet uit?

Stuur een e-mail naar support@tidalcontrol.com, dan nemen we zo snel mogelijk contact met je op.

> **info:**

**Verzamel supportinformatie:** Noteer welke browser je gebruikt, de exacte foutmeldingen en welke stappen je al hebt geprobeerd. Dat versnelt de oplossing aanzienlijk.