License Verification

Basic Information

Since version 9.0, Dynamic Web TWAIN has been using the property ProductKey for license verification at runtime. The property accepts a series of alphanumeric code as the product key which is generated based on the license(s) you own. All editions share the same authentication mechanism. Note:

  1. One product key can be generated from one or many license(s)
  2. The Product Key represents the encrypted license(s). Every product key is unique
  3. The Product Key is also bound to a certain domain since version 11

Generating a Product Key

In version 11, we have applied a new security feature by binding licenses to the purchasers' domain. To generate your product key after you get the full license, please refer to http://developer.dynamsoft.com/dwt/kb/2040

Using the Product Key

Set it during initialization (recommended)

Set ProductKey in the file Dynamsoft.webtwain.config.js

<reference path="dynamsoft.webtwain.initiate.js" />
Dynamsoft.WebTwainEnv.Containers = [{ContainerId:'dwtcontrolContainer',Width:270,Height:350}];

/*please replace ****** with your product key*/
Dynamsoft.WebTwainEnv.ProductKey = '5AKDNCIE2832***';
Dynamsoft.WebTwainEnv.Trial = true;

/* only for debugger output*/
Dynamsoft.WebTwainEnv.Debug = false;

Set it when necessary (not recommended)

Set ProductKey in your own code before calling AcquireImage() method

function AcquireImage() {
      var DWObject = Dynamsoft.WebTwainEnv.GetWebTwain('dwtcontrolContainer');
      DWObject.SelectSource();
      DWObject.OpenSource();
      DWObject.IfShowUI = false;
      DWObject.ProductKey = '5AKDNCIE2832***';
      DWObject.AcquireImage();
}

Multiple Product Keys

If you have multiple product keys generated from multiple serial numbers, you can combine all of them and assign them to the ProductKey property. You will need to separate the keys by semi-colons (;). For example Dynamsoft.WebTwainEnv.ProductKey = '3A0761******;6685BA******',

Common Licensing Errors

Invalid license

image035

As stated in the error message, the product key doesn't exist or is invalid. When this happens, you are still able to scan documents but there will be a watermark on every image. This error message only appears in the purchased version. Please make sure

1) You have generated the product key with the correct purchased license(s)

2) You have bound the license to the correct domain in the product key

The current product key does not match the domain

As stated in the error message, the license(s) is not binding to the correct domain. Please make sure you have done the binding correctly. Please refer to http://kb.dynamsoft.com/questions/40/

The trial license for Dynamic Web TWAIN has expired

As stated in the error message, the trial license(s) used to generate the product key has expired and you will find a watermark on the image scanned.

image036

In this case, you can email our support team (support@dynamsoft.com) and ask for a trial license extension.

Is this page helpful?

Leave a Reply

Your email address will not be published.