Kandji

Collect audit logs from your Kandji account to monitor device management actions and administrative changes. RunReveal polls the Kandji API on a regular schedule.

Kandji Source Tile

Ingest Methods

Setup the ingestion of this source using the guide below.

API Polling

The Kandji source polls your audit logs using the Kandji API.

Setup

  1. Go to Sources in RunReveal
  2. Click the Kandji source tile
  3. Give it a name and click Connect Source
  4. Enter your Kandji API URL (e.g. https://subdomain.api.kandji.io) and API token from Kandji Settings → Access

Your tenant subdomain is the hostname segment in your Kandji API base URL (https://YOUR_SUBDOMAIN.api.kandji.io). In the Kandji web app, open Settings → Access to copy your full API URL and create a token with permission to list audit events. For base URL format and authentication, see the Kandji API documentation.

The integration polls approximately every 60 seconds for new audit events. Historical logs are backfilled on first sync.

Kandji API polling

Schema

The following columns are exposed for this source. RunReveal applies schema normalization across all sources, ensuring uniform field names and data types for cross-source queries and reusable detection logic.

Table: kandji_logs (46 columns)

ColumnType
workspaceIDString
sourceIDString
sourceTypeString
sourceTTLUInt32
receivedAtDateTime
idString
eventTimeDateTime
eventNameString
eventIDString
srcIPString
srcASCountryCodeString
srcASNumberUInt32
srcASOrganizationString
srcCityString
srcConnectionTypeString
srcISPString
srcLatitudeFloat64
srcLongitudeFloat64
srcUserTypeString
dstIPString
dstASCountryCodeString
dstASNumberUInt32
dstASOrganizationString
ColumnType
dstCityString
dstConnectionTypeString
dstISPString
dstLatitudeFloat64
dstLongitudeFloat64
dstUserTypeString
actorMap(String, String)
tagsMap(String, String)
resourcesArray(String)
serviceNameString
enrichmentsArray(Tuple(data Map(String, String), name String, provider String, type String, value String))
readOnlyBool
rawLogString
kandjiEventIdString
actionString
actorIdString
actorTypeString
occurredAtString
targetTypeString
targetIdString
targetComponentString
newStateString
metadataString

Kandji documentation