Set up and configure the Oomnitza integration with our Enterprise API
To stream Kandji data into Oomnitza, your instance-level bearer token should be added to the credentials vault in Oomnitza. For information on how to enable and configure API access for your instance, please refer to this support article.
- Add credentials to the vault in Oomnitza
- Extended connector integration for assets and software
- Device Mappings
- Schedule
- Extended connector integration for users and SaaS users
- User Mappings
- Use API presets to create asset workflows
Add credentials to the vault in Oomnitza
- Log into Oomnitza.
- Click Settings > Credentials, and then click Add new credential (+).
- Add the information details.
- Click the Authorization tab.
- As authorization type select API Key.
- Enter Authorization as the name of the token.
- Enter "Bearer" followed by the API Key.
For example: "Bearer aefgd-adw3n-jknadd78l1kjndc" - Ensure that Add to Header is selected.
- 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
- From the menu, select Settings.
- On the Integrations page, scroll down to the Extended section for Assets.
- Click New Integration.
- In the New Asset Integration sidebar, click Kandji.
- To integrate Oomnitza with the Kandji Asset Load (with Software), click Apply and then click Next twice.
Connect page
- 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.
- To retrieve software information, select Software.
- Select Cloud as the installation type.
- From the Credentials list, select the credentials from the Oomnitza vault that you added for the connection.
- From the Integration Preferences list, select Create & Update.
- Enter the name of the user of the integration.
- Enter your Kandji subdomain. For example, if the URL is
https://subdomain.kandji.io (or https://subdomain.eu.kandji.io if an EU tenant), enter the portion of the URL in bold. - Click Next.
Device 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 above as the Sync Key, such as Device ID.
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.
- Configure your schedule.
- 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
- From the menu, click Settings.
- On the Integrations page, scroll down to the Extended section for User Integrations.
- Click New Integration.
- In the New User Integration sidebar, click Kandji.
- 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.
- 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.
- From the User Selection list, select User plus SaaS User.
- From the installation type list, select Cloud.
- From the Credentials list, select the credentials from the Oomnitza vault.
- From the Integration Preferences list, select Update only.
- Enter the name of the user of the integration.
- Enter your Kandji subdomain. For example, if the URL is
https://subdomain.kandji.io (or https://subdomain.eu.kandji.io if an EU tenant), enter the portion of the URL in bold. - Click Next.
User 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 above as the Sync Key such as the email address of the user.
Want to map more Kandji asset fields to Oomnitza?
Contact Oomnitza Support, or see Mapping extended connectors.
When you've completed mapping the Kandji fields to the 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.
- Configure your schedule.
- 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, use the built-in presets for assets.
To add a preset to a workflow, complete these steps:
- Click Assets > Workflow.
- Click Add (+) and enter the name and description of the workflow.
- Click Add new. A Begin and End block is automatically added to the Sandbox.
- Drag and drop the API block onto the Sandbox.
- Click Edit on the API block.
- Enter Kandji to search for the presets.
- Select a preset:
- Kandji Clear Passcode
- Kandji Device Restart
- Kandji Device Set Name
- Kandji Device Shutdown
- Kandji Erase Device
- Kandji Get Asset Details
- Kandji Lock Device
- Kandji Unlock Account
- Configure and save your changes.
- Edit the Begin block to set the trigger for the workflow.
- Connect the three blocks together.
- Validate, launch, and save your workflow.
See the guide on Getting Started with Oomnitza for more actionable insights that help you manage your assets.