Extended Connector for Hexnode Assets, Software, and Users

Let Oomnitza be your single source of truth!

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

Connect Oomnitza and Hexnode 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 asset and software and user information
  • Configurable reports to share information about assets and users with your colleagues and management
  • Configurable asset workflows that you can easily create such as:
    • Workflows for locking, restarting, and powering off devices
    • Workflows for scanning devices
    • Workflows for clearing a device pass code
    • Workflows for broadcasting messages
    • Workflows for disabling and enabling kiosk mode
    • Workflows for enabling and disabling lost mode
    • Workflows for changing device ownership
    • Workflows for wiping devices

Integrate Hexnode with Oomnitza

Configure the following extended connectors:

blue_link.svg  Extended connector integration for assets and software

blue_link.svg  Extended connector integration for users and SaaS users

Before you start

To stream Hexnode data into Oomnitza, you must add your Hexnode authentication credentials to the credentials vault in Oomnitza.  To do this, you need your API key.

blue_link.svg Retrieve your Hexnode API key

blue_link.svg Learn more about Hexnode API Authentication

Add the Hexnode company portal to global settings

To save time entering information when you integrate Hexnode, you can add your company portal as a global variable in Oomnitza.

  1. In Oomnitza, click Settings > Global Settings.
  2. Click Add new variable (+). 
  3. Enter Hexnode.Comany Portal as the variable name.
  4. Enter the value for your Hexnode company portal.
  5. Click SAVE.

Add credentials to the vault in Oomnitza

To authorize connections between Oomnitza and Hexnode, 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 the API Key, which is the secret key that you got from Hexnode.
  8. Ensure that Add to Header is selected.
  9. Click CREATE

You use the credentials that you added to create and customize your Hexnode 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 Hexnode.
  5. To integrate Oomnitza with the Hexnode Asset Load with Software, click APPLY and then click NEXT twice.

Connect page

  1. Enter a descriptive name for the integration such as Hexnode Mobile Devices and Software. That'll be the name of the integration that is shown on the Integrations page.
  2. Select Cloud as the installation type.
  3. From the Credentials list, select the credentials from the Oomnitza vault that you added for the connection.
  4. From the Integration Preferences list, select Create & Update
  5. Enter the name of the user of the integration.
  6. Enter the Hexnode customer portal. For example, if the URL is
    https:// portalname .hexnodemdm.com , you enter the highlighted part of the URL.
  7. Click Next.

Mappings

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

blue_link.svg Learn more about mapping

To take advantage of workflows, ensure you map the following Hexnode fields to Oomnitza:

Hexnode ID field

  1. Scroll down to the Hexnode Id field.
  2. From the list, select Add new Oomnitza assets field.
  3. Optional. Change the label to Hexnode Device ID.
  4. In the Information tab in the Field Information dialog, select the Unique checkbox.
  5. Click CREATE.

Select the Sync key checkbox next to the mapped field.

User Phone Number field

  1. Scroll down and to the User Phone Number field.
  2. From the list, select Add new Oomnitza assets field.

  3. Optional. Change the label to Hexnode Mobile Number.

  4. Click CREATE.

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

Schedule

By default, Hexnode 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.

edit-integration.svg

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 Hexnode.
  5. To integrate Oomnitza with the Hexnode User Load, click APPLY and then click NEXT twice.

Connect page

Best practice
To ensure that only live user records are streamed from Hexnode 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. You can then decide whether to upload the user records that were skipped by changing your integration preference to create and upload. See Access error logs.

  1. Enter a descriptive name for the integration such as Hexnode 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 Hexnode customer portal. For example, if the URL is
    https:// portalname .hexnodemdm.com , you enter the highlighted part of the URL.
  8. Click Next.

Mappings

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

Standard Hexnode to Oomnitza mappings

The following Hexnode fields can be mapped to Oomnitza: 

  • Connector Synch Time
  • Domain
  • Email
  • Id
  • Name
  • Phone Number
  • Total Devices

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

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

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

Schedule

By default, Hexnode 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.

edit-integration.svg

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. 

Review the errors. You can then decide whether you need to change your integration preference from Update only to Create & Update.

Use presets to create asset workflows

To reduce costs by automating repetitive and  complex tasks, take advantage of the built-in presets that Oomnitza provides.

To choose a preset, 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 are automatically added to the Sandbox.
  4. Drag and drop the API block onto the Sandbox.
  5. Click Edit on the API block and enter Hexnode in the search field. 
  6. Select a preset:
    • Hexnode Broadcast Message
    • Hexnode Change Ownership
    • Hexnode Clear Device Passcode
    • Hexnode Delete User
    • Hexnode Disable Kiosk Device
    • Hexnode Disable Lost Mode Device 
    • Hexnode Enable Kiosk Device 
    • Hexnode Enable Lost Mode Device
    • Hexnode Lock Device
    • Hexnode Power Off Device
    • Hexnode Restart Device
    • Hexnode Scan Device
    • Hexnode Wipe Device
  7. Click >, configure the API Block, and save your changes.
  8. To trigger the workflow, edit the Begin Block.
  9. Connect the Blocks. 
  10. Validate, launch, and save your workflow.

blue_link.svg Understanding Workflows

Unleash the power of Oomnitza

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

  • Configure dashboards for your assets
  • Configure workflows for automating onboading and offboarding employees and tracking lost and stolen assets
  • Configure custom reports about your assets 

blue_link.svg See Getting started.

 

Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.
Powered by Zendesk