Creating an extended integration for Kandji assets, software, and users

Let Oomnitza be your single source of truth!

You'll get visibility of your assets and software as data from Kandjii is automatically transformed into consumable information and actionable insights.

Connect Oomnitza and Kandji in minutes

Get the information and insights that you need to reduce costs and the time that you spend on administration tasks such as:

• Configurable dashboards and list views of key mobile asset, software, and user information
• Configurable reports to share information about mobile assets and users with your colleagues and management
• Configurable workflows such as:
  • Clear Passcode workflows
  • Device Restart workflows
  • Device Set Name workflows
  • Device Shutdown workflows
  • Erase Device workflows
  • Get Asset Details workflows
  • Lock Device workflows
  • Unlock Account workflows

Learn more about Kandji

Integrate Kandji with Oomnitza

Configure the following extended connectors

 Extended connector integration for assets and software

 Extended connector integration for users and SaaS users

Create workflows

 Use API presets to create asset workflows

Before you start

To stream Kandji data into Oomnitza, you must add your Kandji authentication credentials to the credentials vault in Oomnitza. 

The REST API for Kandji Devices uses API token based authentication.

See Generate an API token in Kandji API.

Add credentials to the vault in Oomnitza

To authorize connections between Oomnitza and Kandjii, complete these steps:

1. Log into Oomnitza.
2. Click Settings > Credentials, and then click Add new credential (+).
3. Add the information details.
4. Click the AUTHORIZATION tab.
5. As authorization type select API Key.
6. Enter Authorization as the name of the token. 
7. Enter "Bearer" followed by the API Key. For example,Bearer aefgd-adw3n-jknadd78l1kjndc.
8. Ensure that Add to Header is selected.
9. Click CREATE. 

Next step

You can use the credentials that you added to create and customize your Kandji integrations with Oomnitza.

Extended connector integration for assets and software

Info and connect details

1. From the menu, select Settings.
2. On the Integrations page, scroll down to the Extended section for Assets.
3. Click NEW INTEGRATION.
4. In the New Asset Integration sidebar, click Kandji.
5. To integrate Oomnitza with the Kandji Asset Load (with Software), click APPLY and then click NEXT twice.

Connect page

1. Enter a descriptive name for the integration such as Kandji Devices and Software. That'll be the name of the integration that is shown on the Integrations page.
2. To retrieve software information, select Software.
3. Select Cloud as the installation type.
4. From the Credentials list, select the credentials from the Oomnitza vault that you added for the connection.
5. From the Integration Preferences list, select Create & Update. 
6. Enter the name of the user of the integration.
7. Enter your Kandji subdomain. For example, if the URL is
   https:// subdomain .kandji.io , you enter the highlighted part of the URL
8. Click Next.

Mappings

Map the Kandji fields to Oomnitza fields and create custom mappings to get the information that you need to manage your assets.

Standard Kandji to Oomnitza mappings

The following Kandji fields can be mapped to Oomnitza: 

Asset Tag
Blueprint ID
Connector Sync Time
Device ID
Device Name
Last Check In
Model
OS Version
Platform
Serial Number
User

Ensure that you select one of the fields as the Sync Key such as Device ID. 

 Learn more about mapping

Want to map more Kandji user fields to Oomnitza?
Contact Support, or see Mapping extended connectors.

When you've completed mapping the Kandji fields to Oomnitza fields, click NEXT.

Schedule

By default, Kandji asset and software data is streamed to Oomnitza once every day.

You can configure the schedule to meet your needs such as changing the interval or changing the time so that the data is streamed when your system isn't busy.

1. Configure your schedule.
2. Click FINISH.

Result

A new tile is created for the integration on the Integrations page. 

What to do next

If you want to see what information is collected now, click the tile on the Integrations page and click RUN.

Figure: Mock-up for illustration purposes

If you want to change the integration settings, you can click a navigation link on the page, such as 4 Mappings, and edit the settings. 

Tip
To view the information that is collected about your mobile assets, click Assets. To view the information about software , click an asset and then click the Software tab.

Extended connector integration for users and SaaS users

Info and connect details

1. From the menu, click Settings.
2. On the Integrations page, scroll down to the Extended section for User Integrations.
3. Click NEW INTEGRATION.
4. In the New User Integration sidebar, click Kandji.
5. To integrate Oomnitza with the Kandji User Load, click APPLY and then click NEXT twice.

Connect page

Best practice
To ensure that only live user records are streamed from Kandji to Oomnitza, choose Update only as your integration preference. When you run the integration, you can check the error logs to see which user records weren't uploaded and why they weren't uploaded. See Access error logs.

1. Enter a descriptive name for the integration such as Kandji Users. That'll be the name of the user integration that is shown on the Integrations page.
2. From the User Selection list, select User plus SaaS User.
3. From the installation type list, select Cloud.
4. From the Credentials list, select the credentials from the Oomnitza vault.
5. From the Integration Preferences list, select Update only.   
6. Enter the name of the user of the integration.
7. Enter your Kandji subdomain. For example, if the URL is
8. https:// subdomain .kandji.io , you enter the highlighted part of the URL
9. Click Next.

Mappings

Map the Kandji fields to Oomnitza fields and create custom mappings to get the user information that you need.

Standard Kandji to Oomnitza mappings

The following Kandji fields can be mapped to Oomnitza: 

• Connector Sync Time
• User Email
• User ID
• User Name
• User Is Archived

Ensure that you select one of the fields as the Sync Key such as the email address of the user. 

Want to map more Kandji asset fields to Oomnitza?
Contact Support, or see Mapping extended connectors.

When you've completed mapping the Kandji fields to Oomnitza fields, click NEXT.

Schedule

By default, Kandji asset and software data is streamed to Oomnitza once every day.

You can configure the schedule to meet your needs such as changing the interval or changing the time so that the data is streamed when your system isn't busy.

1. Configure your schedule.
2. Click FINISH.

Result

A new tile is created for the integration on the Integrations page. 

What to do next

If you want to see what information is collected now, click the tile on the Integrations page and click RUN.

Figure: Mock-up for illustration purposes

If you want to change the integration settings, you can click a navigation link on the page, such as 4 Mappings, and edit the settings. 

Use API presets to create asset workflows

To reduce costs by automating repetitive and  complex tasks, take advantage of the built-in presets for assets.

To add a preset to a workflow, complete these steps:

1. Click Assets > Workflow.
2. Click Add (+) and enter the name and description of the workflow.
3. Click Add new. A Begin and End block is automatically added to the Sandbox.   
4. Drag and drop the API block onto the Sandbox.
5. Click Edit on the API block.
6. Enter Kandji to search for the presets.
7. Select a preset:
   1. Kandji Clear Passcode
   2. Kandji Device Restart
   3. Kandji Device Set Name
   4. Kandji Device Shutdown
   5. Kandji Erase Device
   6. Kandji Get Asset Details
   7. Kandji Lock Device
   8. Kandji Unlock Account
8. Configure and save your changes. 
9. Edit the Begin block to set the trigger for the workflow.
10. Connect the three blocks together.
11. Validate, launch, and save your workflow.

Understanding Workflows

Enhanced Workflows

Unleash the power of Oomnitza

To get valuable actionable insights that help you manage your assets, learn how to:

• Configure dashboards
• Configure workflows 
• Configure custom reports  

See Getting started.