Using Toolbox

Introduction

Treek’s Licensing Library toolbox is designed to create license signing keys, for license issuance and testing. It is GUI application, which makes possible to non-programmer to create license files and supply them to customers.

Working with license signing keys

You can work with keys on first tab of toolbox window, called “Author keypair“. If you’re going to create new keys for new application, click  “Generate new” button. You’ll be prompted for path, where will be your keyfile saved. You can also load previously generated keyfile by clicking “Load keypair” button. In that case, you’ll be prompted for keyfile.

When generating new keys, you can optionally encrypt your license signing key with your password and Rijndael algorithm.

By clicking “Copy public key” you can get a public key XML for use in source code.

Issuing license

  1. First, be sure, that you’re using the right keypair (corresponding with public key in your application).
  2. Then go to “License generation” tab.
  3. Fill the product name and license owner as minimum.
  4. Click generate license file
  5. Send license file to customer

You may specify hardware ID and expiration date for license (optionally). When you specify hardware ID, license will be working only on computer with that hardware ID. You can add more hardware IDs by separating them by comma.

When you specify the expiration date, Treek’s Licensing Library will recognize license as invalid after this date. Manipulation with user’s computer time won’t break expiration date mechanism.

Testing license file

On the third tab of toolbox you can test license file, if it’ll work in your application. To do this:

  1. Copy your public key from application and paste it to the text field called “Author’s public key”
  2. Specify the path to license file.
  3. Click “Check license file”

You’ll receive error details or success message. On success, you’ll get licensedetails.

Library integrity check

Toolbox does the check of TreeksLicensingLibrary.dll authenticity by computing hash of the file. This feature is there to easily find SHA1 hash of original dll file, so developer can easily implement check against dll replacement attack.

Developer license

When you purchase Treek’s Licensing Library, you’ll receive your license file, which you can use to avoid demo messages in toolbox. Please note, that this will remove demo message only in toolbox. To remove demo message from your application, follow this example.