Online Activation By Authorization Code

With QLM v11, users can activate their license simply by using their email address. There's no need to remember an Activation Key.

[Watch a video tutorial]

Activation by authorization code works as follows:

• A user provides his email rather than a license key for activation.

• The server determines if the user owns a license and if he does, an email or SMS message is sent to the user with a 6-digit, easy-to-type, authorization code.

• The user receives the authorization code and activates the license using the authorization code.

If the license is not directly associated with the email address of the user, QLM looks up the organization associated with the specified email address and uses license keys associated with the organization. This option is configurable as shown in the screenshot below.

AAC is supported in 3 different ways:

1. From the QLM License Wizard

2. By calling the QlmLicense.RequestAuthorizationCodeForActivation and QlmLicense.ActivateLicenseByAuthorizationCode

3. By calling the HTTP method RequestAuthorizationCodeForActivationHttpand ActivateLicenseByAuthorizationCodeHttp

AAC using the QLM License Wizard

To support AAC from the QLM License Wizard:

• Launch the QLM Management Console

• Go to the Protect Your Application tab

• Set the QlmEnableActivationByAuthorizationCode property to true

• Save the wizard settings XML file and LicenseValidator class

• Update your application to use these files

You must then configure your QLM License Server to send emails. To do so, follow the instructions in the section "Configure the QLM License Server to send emails using SMTP" of this knowledge base article.

You can also send the Authorization Code by SMS message. To send the authorization code by SMS message, you must use a 3rd party SMS provider. QLM is integrated with Twilio for sending SMS messages.

To configure your Twilio SMS settings:

• Go to the Manage Keys / Sites / Server Properties

• Locate the activation category

• Set the 3 properties: smsAccountNumber, smsAuthenticationToken and smsPhoneNumber

You can also configure the following server properties to control the behaviour of AAC:

• activationByAuthorizationCodeEmailTemplate: the template of the email sent to the user with the authorization code. The default email template is: AuthorizationCode

• activationByAuthorizationCodeExpiryDuration: the expiry duration in minutes of an authorization code. Once an authorization code has expired, it will be deleted from the server. The default value is 10 minutes.

• activationByAuthorizationCodeMaxAttempts: the maximum number of attempts allowed.

When the end user launches your application for the first time:

• The QLM License Wizard is launched

• The user selects Online Activation

• The user enters the email address used at the time of purchase instead of entering an Activation Key

• The user clicks Activate

• The QLM License Wizard contacts the License Server and sends it the user's email address

• The QLM License Server locates the customer's license, generates a random 6-digit Authorization Code and emails it or texts it to the customer

• The QLM License Wizard prompts the user to enter a 6-digit code

• Once the user receives the email/text, he/she enters the 6-digit code and activates the license

AAC using the QlmLicense API

• Call QlmLicense.RequestAuthorizationCodeForActivation

• Call QlmLicense.ActivateLicenseByAuthorizationCode

AAC using the HTTP API

• Call RequestAuthorizationCodeForActivationHttp

• Call ActivateKeyByAuthorizationCodeHttp