Manage device groups

You use device groups and access keys for device-based licensing.

A device group can contain one or more access keys. An access key contains the information needed for authorizing client application access to 10Duke Enterprise.

You can use access keys, for example, to control access to licensed software that is installed on a particular device (a machine or PC). If your product is a device with embedded software, you can store an access key in all your devices, and the software uses the access key to get authorization for license consumption from 10Duke Enterprise.

You create and manage device groups and access keys in 10Duke SysAdmin.

Your 10Duke SysAdmin configuration must have the device group feature enabled. Contact the 10Duke Integration Support team if needed.


You use device groups and access keys as follows:

  1. In SysAdmin, create a device group for an organization, and create an access key in the device group.

    In device-based licensing, the organization represents, for example, you as the software vendor, or a reseller.

  2. In the organization’s entitlement, grant the device group access to the licenses to your software.

    This allows the licenses to be consumed on devices that contain the access key you created in the device group.

  3. Distribute the access key, for example, by storing it on the devices or by shipping it with your software.

    If the key is not delivered by storing it on the device, someone must manually store it to a location indicated by you.

  4. When the client application is started on the device, the application finds the access key stored on the device.

    The access key is an access token that the client application must include in all requests to the 10Duke Enterprise APIs.

    We recommend that after the client application has read the key, it stores the key in memory for the duration of the license lease.

  5. The client application makes a license consumption call with the access token to the 10Duke License Consumption API, and 10Duke Enterprise grants a license lease and returns a license token.

In the above scenario, the same access key was used on all devices. You can also use a different access key per device, for example, if there’s a need to track usage per device.

View device groups

  1. In the left sidebar, go to IDENTITY > Organizations.

  2. In the organization table, select the organization and select Actions > Manage device groups.

    The organization’s device group table opens.

  3. To view a device group, select it in the table. The details open below the table.

    • The Details tab shows the basic details.

    • The Access key(s) tab shows the access keys created for this device group.

    For more information on these, see the instructions on how to create device groups and define the access keys.

See more