How to Import People & Devices from Kolide into Assets

[#1]

In this blog we will cover how to import people and devices data from Kolide to Assets.

OnLink lets you import People and Devices from Kolide into Assets by connecting to the Kolide API, and mapping fields such as id, name, email, operating_system, and hardware_model to your Assets schema. The sync can then run manually or on a schedule.

What is Kolide?

Kolide is a device-trust and endpoint visibility platform that ensures only secure, compliant devices can access company applications. It focuses on zero-trust access, user transparency, and lightweight device checks.

Key Kolide Features

• Verifies device security posture before allowing SSO access
• Tracks macOS, Windows, and Linux endpoints
• Provides human-readable guidance to end users for fixing compliance issues
• Captures detailed device metadata such as OS version, serial numbers, model identifiers, hardware UUID, and authentication state
• Supports People directory for linking users to their registered devices

How to Retrieve People Data from Kolide

Kolide exposes a People API:

API Endpoint:

GET https://kolideapi.readme.io/reference/get_people

Sample People Object

{

  "id": "string",
  "name": "string",
  "email": "string",
  "created_at": "2025-11-17T14:08:19.090Z",
  "last_authenticated_at": "2025-11-17T14:08:19.090Z",
  "has_registered_device": true,
  "usernames": [0]

}

How to Retrieve Devices from Kolide

API Endpoint:

GET https://kolideapi.readme.io/reference/get_devices

Sample Device Object

{

  "id": "string",
  "name": "string",
  "registered_at": "2025-11-17T14:09:50.253Z",
  "last_authenticated_at": "2025-11-17T14:09:50.253Z",
  "registered_owner_info": 
  {
    "identifier": "string",
    "location": "string"
  },

  "operating_system": "string",
  "hardware_model": "string",
  "serial": "string",
  "hardware_uuid": "string",
  "note": "string",
  "auth_state": "Will Block",
  "will_block_at": "2025-11-17T14:09:50.253Z",
  "product_image_url": "string",
  "auth_configuration": {
    "device_id": "string",
    "authentication_mode": "string",
    "person_groups": [

      {
        "id": "string",
        "name": "string"
      }
    ]
  },

  "device_type": "Mac",
  "form_factor": "Computer"
}

Importing Kolide People & Devices into Assets Using OnLink

Establish the Kolide Connection

1. Go to Jira → Manage Your Apps → OnLink → Connections
   
2. Click Add System
   
3. Choose Other Data Sources
   
4. Enter:
   
   • Kolide API URL
     
   • API Key
     
     
5. Save and test the connection
   
   

Configure the Assets Import

Next, create an import job in Assets:

1. Go to Assets → Your Schema
   
2. Create a new import configuration
   
3. Select OnLink Importer
   
4. Choose the object type you want to populate (People, Device)
   
   

Mapping Kolide People Fields (Example)

Use OnLink’s mapping:

key:id=id
map:name=Full Name
map:email=Email
config:api=people

 

Mapping Breakdown

Mapping	Meaning
key:id=id	Uses Kolide’s id as the unique key so OnLink updates existing objects instead of duplicating them
map:name=Full Name	Maps Kolide’s name to your Assets “Full Name” attribute
map:email=Email	Maps Kolide email → Assets email
config:api=people	Tells OnLink to pull People objects

Any field from the Kolide People API can be mapped.

Mapping Kolide Device Fields (Example)

You can map any device-level fields, such as:

• operating_system
• hardware_model
• serial
• hardware_uuid
• auth_state
• registered_owner_info.identifier
  
  

Your configuration might look like:

key:id=id
map:name=Device Name
map:operating_system=OS
map:hardware_model=Model
map:serial=Serial Number
map:hardware_uuid=Hardware UUID
config:api=devices

FAQ

1. Can OnLink import both People and Devices from Kolide?

Yes. OnLink can pull any object exposed through the Kolide API and map it to Assets object types.

2. Do I need to write code to integrate Kolide with Assets?

No. OnLink handles API calls, pagination, scheduling, and field mapping without custom scripting.

3. Can device owners be linked to their user objects?

Yes. Kolide provides user identifiers that can be used to link People objects to Device objects inside Assets.

4. How often can I sync Kolide data into Assets?

You can run manual jobs or configure automated schedules at your preferred frequency.

5. What if a Kolide record changes?

OnLink updates the existing Assets object as long as the key field (usually id) stays consistent.

If you’re already using Kolide, give OnLink a try and see how much easier your workflow becomes. With support for 50+ data sources, OnLink lets you pull everything into Assets without hopping between apps or writing custom scripts.