Download an organization license

With organization licenses, you can download a license (token) for a user on the organization’s Entitlements tab in 10Duke SysAdmin.

An example use case is that you have a customer whose users need to use your software offline.

You can manually activate licenses leases for users and download license tokens. The customer can then deliver the license tokens to the users, for example, on a USB drive. A user can consume the license until their token expires.

You cannot download a consumer user’s personal license in SysAdmin, but you can use the 10Duke License Consumption API to consume a license on behalf of another user and deliver the returned license token to the user. Include the parameter onBehalfOfId=<user UUID> in the license consumption request. This requires a special permission to act on behalf of the user. Contact the 10Duke Integration Support team for more information.

Before you start

  • Your client application must support taking external license tokens into use, for example, by providing a feature for importing a license token.

  • Make sure the user belongs to a user group that is authorized to consume the license. You can see a user’s user groups in their user account.

  • You need to know the hardware ID of the device running your software application. License consumption is restricted to a specific computer or hardware based on the hardware ID you define for the token.

Download the license token

To activate an organization license lease for a user and download the license token:

  1. In SysAdmin in the left sidebar, go to LICENSES > Organization.

  2. Search and select the organization and click Confirm.

  3. Go to the Entitlements tab and select an entitlement.

  4. Go to the Licenses tab, select the license, and select Actions > Download a license. A side panel opens.

  5. Select the user who will consume the license.

  6. If the license’ license model anchors license sessions to the hardware ID, in Hardware ID enter the ID of the computer or hardware on which the user will be consuming the license.

    The ID must match the hardware ID of the machine on which the client application is installed and where the license token will be stored.

    For testing purposes, you can also generate an ID here: open the Advanced section and enable Generate hardware ID.

  7. In Software version under Advanced (optional), define which version of the software the user is allowed to use with this token.

  8. In Consumption mode under Advanced, define how long the license token is valid.

    With the default settings, offline license consumption mode is used, and the license model determines how long the license token is valid.

    • Consumption mode: Select whether the user will consume the license online or offline (default).

    • Lease duration (optional): Define how long the license token is valid: select the time unit and enter the time.

  9. Click Consume license to activate the license lease and generate a license token.

    The Expires field shows the date and time when the lease (the license token) expires.

    To view the license token’s details, open the License token information section. License JWT payload shows the fields in the JWT token.

  10. Click Download JWT to download the license token (or end the license lease by clicking Release license).

    Note: You cannot view or download the license token in SysAdmin anymore after this.

Next steps

  • Deliver the license token to the customer and instruct them how to take it into use.

  • If needed, you can end the license lease before it expires.

On this page