Page tree
Skip to end of metadata
Go to start of metadata

Device-based licensing is a feature of application masking that helps administrators manage their application hiding rules in a way that is compliant with product license agreements. The feature is designed with software products that are licensed on a per-device basis.

This feature will allow administrators to:

  • Set a time-frame during which an assigned license cannot be unassigned
  • Record a time stamp of when a license was assigned to a device
  • Record a time stamp of when a license was unassigned to a device
  • Generate a report showing license usage for a period of time
  • Warn the administrator when they attempt to un-assign a license that has not been assigned for the minimum time

Changing Licensing Parameters

The first step in using device-based licensing is to set a minimum number of days for a license to be assigned. This can be accomplished in the Rule Editor by clicking File | Change Licensing Parameters and entering a value. This value is stored with the rule assignment file and is specific to each rule set.

The device-based licensing features discussed hereafter will only be effective if this step is complete.

Editing Rule Assignments for Devices

Assigning devices to have an application masked or unmasked is done using the same process as other rule assignment types. Device-based licensing is built with a more generic function that allows rules to be created based on environment variables. While rules can be created based on any environment variable, devices are identified by an environment variable CLIENTNAME that is set by the remote access software (e.g., Microsoft Remote Desktop, Citrix Receiver, etc.) when a device connects to a server.

A device rule can be entered by clicking Add | Environment Variable in the rule assignment dialog, and by entering the environment variable CLIENTNAME and entering a client name. 

Wildcards (?, *) are supported in the value field.

Optionally, you can click the button From File button and select a text file containing a list of device names, one item per line. A rule assignment will then be created for each device name from the file.

Making the rule assignment sets "Applies = No" by default, which means that a license has been assigned. Note that the logical on/off for a license being assigned is reversed from the logic of the application being hidden. So "Applies = No" means that the hiding rule does not apply to that device, which means the software is visible to the user, which means a license is assigned.

If you attempt to set the assignment to "Applies = Yes" or to delete the assignment, and if it has been set to Applies=No for less than the minimum number of days for license assignment, then a warning dialog box will appear. You can still delete the rule assignment, but the warning indicates that you may be doing something that violates your license agreements.

Licensing Reports

A report can be generated to show the historical license assignments by clicking File | Licensing Report, and selecting a date range for the report (default is the previous one year period). The report generated is a PDF file that looks similar to the following:


  • No labels