Kandji (nu Iru)

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

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.