Hexnode UEM

Driver: hexnode

Connects GEM to a Hexnode Unified Endpoint Management tenant over its HTTPS REST API. Intended for reading the managed-device inventory of a site's tablets and phones — device details, installed applications, last known locations, and applied policies — and for maintaining device groups.

One GEM device represents one Hexnode tenant. The driver creates no zones and implements no zone verbs; everything is done with explicit commands.

The API helper is not yet implemented

The internal hexnodeApiCall helper that performs the HTTP round-trip is currently a stub, so every command below returns undefined rather than data. The command surface, routing, and connection validation are in place — the transport is what remains. Do not build macros or automations against this driver until the helper ships.

Prerequisites

• A Hexnode tenant with the devices enrolled.
• An API key generated in the Hexnode admin console (Admin → API).
• The tenant's API base URL, of the form https://yourcompany.hexnodemdm.com/api/v1/.
• Outbound HTTPS from the GEM server.

Setup

1. Open Devices (System → Devices), choose Add Device, and pick the driver hexnode.
2. Set Hexnode API URL to the tenant API root. A trailing slash is optional — the driver adds one if it is missing.
3. Set API Key to the key generated in the Hexnode console. It is stored encrypted.
4. Enable and save the device.

Both attributes are required. If either is missing the driver logs hexnode missing api_url or hexnode missing api_key and stops before connecting.

Attributes

Device

Attribute	Required	Description
api_url	yes	Tenant API base URL, e.g. https://yourcompany.hexnodemdm.com/api/v1/.
api_key	yes	Hexnode API key. Stored encrypted.

Commands

Command	Args	Description
list_devices	—	List every managed device on the tenant.
get_device	device_id	Details for one managed device.
get_device_applications	device_id	Applications installed on a device.
get_device_locations	device_id	Reported locations for a device.
get_device_policies	device_id	Policies applied to a device.
list_device_groups	—	List device groups.
create_device_group	—	Create a device group.
get_device_group	group_id	Details for one device group.
update_device_group	group_id	Update a device group.
delete_device_group	group_id	Delete a device group.
add_group_device	group_id	Add a device to a group.
remove_group_device	group_id	Remove a device from a group.

Troubleshooting

Symptom	Check
Every command returns nothing	Expected today — the hexnodeApiCall helper is stubbed and performs no request.
Log shows hexnode missing api_url or hexnode missing api_key	Set both attributes on the device and save. The URL must point at the tenant's /api/v1/ root.
Log shows hexnode error: …	The API rejected the request. Confirm the key is still valid in the Hexnode console and that the GEM host has outbound HTTPS.

See also

• Devices — adding the device and reading its log.
• Commands — running commands by hand.