QLM Professional is composed of 2 components: (a) a license server that provides a framework for issuing and managing license keys and (b) a client application that communicates with the license server and acts as a user interface to the license server.
QLM Professional allows you to implement online software activation. Software activation is the process of generating a computer bound license key over the internet. In order to implement software activation, you work with 2 types of license keys. The first key is called "Activation Key". This is the key that you send to your customer when they purchase your software. The activation key can be sent to your customer directly from your eCommerce provider (see other section on how to integrate QLM with your eCommerce provider) or manually. This key does not enable your software. It simply allows the user to activate his license. If a user purchases several copies of your software, you can send them one activation key for all purchased licenses or one activation key per license.
From your application, the user enters the activation key. Your application calls the QLM API which sends the activation key along with a with a computer unique identifier to the QLM web service. The QLM web service then generates the second type of license key called "Computer Bound" and sends this key back to your application. The computer bound key enables your application.
The first step in creating license keys for your products is to define each product. Click on the Define Products tab and then click on New. Enter the Product Name, the Major and Minor version of the product. The Product ID and the GUID fields are automatically generated.You will need these values when you use the API to validate license keys. You may also associate up to 32 features with each of your products.
- As of QLM version 5, the encryption key is no longer required and has been superseeded by the public/private key pair found on the Encryption Keys tab.
- If you are evaluating QLM and are using the Demo License Server hosted on our web site, you should use the built-in Demo product as you cannot publish your own product to the Demo License Server that's being used by other users who are evaluating QLM.
Generate license keys
Once you have defined your products, you can generate license keys for each product. There are 2 types of license keys: permanent, and evaluation/subscription keys. Evaluation/Subscription keys can specify the duration of the license, an expiry date or both.
Prior to creating license keys with QLM Professional, you need to setup the QLM web service and a database that will host the license keys. For instructions on installing the QLM web service and the database, refer to the Help. For evaluation purposes, Soraco provides you with a demo web service and a database. The only restriction of our demo web service is that you cannot publish your products to the web service; you can only work with the default product Demo. Additionally, note that the database content on the demo web service is regularly reset.
To generate license keys with QLM Professional, click on the Manage Keys tab, then click on the Create button. Select a Product, the number of keys to generate, the type of keys to generate and then click on the OK button. QLM stores the generated keys in a database.
Modify your application
The simplest way to integrate QLM Pro to your application, is to use the QLM .NET Activation User Control or the QLM License Wizard standalone application.
The QLM .NET Activation User Control provides a ready-to-go license activation form. If your application is developed in .NET WinForm or WPF, check out this tutorial for a step by step instruction on how to integrate using the QLM .NET Control.
If your application is not a .NET application, you can use the QLM License Wizard standalone appication to manage the license activation process. For a tutorial on how to use the QLM License Wizard, click here .
Of course, you can always create your own license registration form and use our extensive API to manage license validation and activation.
Below are step by step instructions to integrate QLM Pro in your application:
1. From the Protect your application tab, follow the instructions in the wizard. QLM will generate the code that you need to add to your application.
2. For .NET applications:
a) add to your application a reference to: QlmLicenseLib.dll
a) add to your application a reference to: QlmControls.dll (if you want to use the QLM .NET User controls)
b) add to your application the following file (not as a reference, but as a file that will be copied to your bin folder): x86\IsLicense50.dll and x64\IsLicense50.dll. Note that as of QLM v9, this step is optional but recommended.
3. In your application, as soon as your application is started, call the ValidateLicenseAtStartup function (found in the generated code above).
4. If the ValidateLicenseAtStartup function returns false, it means there is no valid license and you must prompt the user for a license.
5. If you are using the QLM .NET Control, display a form containing the QLM .NET Control to allow the user to register his license.
6. If you are not using the QLM .NET Control, launch the QLM License Wizard application (with the proper command line arguments).
6. Upon successful activation of the license, close the license form and display your application.
For more details about specific APIs, refer to the API reference found in the online help.
Several sample applications are included in the Samples folder developed in VB6, VC6, VB.NET, C#, VC7, and Excel.
All QLM Pro samples are located in the folder:
C:\Users\Public\Documents\Quick License Manager\Samples\qlmpro
Samples are grouped in programming languages.
- Windows\DotNet\C#\QlmProSample - This sample shows how to add online activation to your C# Windows Forms application by using the QLM API.
- Windows\DotNet\C#\AspDotNetSample - This sample shows how to add online activation to your C# ASP.NET application by using the QLM API.
- Windows\DotNet\C#\QlmApiSample - This sample shows how to implement online activation using plain http requests in your C# application.
- Windows\DotNet\VB.NET\QlmApiSample - This sample shows how to implement online activation using plain http requests in your VB.NET application.
- Windows\C++\QlmLicenseWizard: Visual Studios 2005 sample shows how to add online activation to your C++ application.
MS Access Sample
- Windows\MSAccess2003: MS Access sample shows how to add online activation to your MS Access 2003 application.
- Windows\Excel: Excel sample shows how to add online activation to your Excel application.
- Windows\VB6: VB6 sample shows how to add online activation to your VB6 application.
- Windows\Delphi: Delphi sample shows how to add online activation to your Delphi application.
- Windows\OutlookAddIn: Outlook sample shows how to add online activation to your Outlook add-in.
Windows Phone (7)
- Windows\WindowsPhone: Windows Phone sample shows how to add online activation to your Windows Phone application.
Windows 8 Store
- Windows\Win8Store: Windows 8 Store sample shows how to add online activation to your Windows 8 application.