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.
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:
From the QLM License Wizard
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
AAC using the HTTP API
Last updated
