Last Modified October 1, 2026
  1. Home
  2. Guides
  3. Activation API V1 Reference
  4. WEB_Validate

WEB_Validate() API

Will perform a DNA Server Validation to ensure that the License is valid and the license conditions are respected.

Optionaly (recommended), you can implement a Local Validation to speed up the validation versus always validating with the DNA Servers, as follows:

  1. read-in the DNA License if it exists
  2. verify the Signature
  3. if using node-locking recreate the <DEVICE_ID> and compare to the <DEVICE_ID> value in the DNA License
  4. check the <EXPIRY_DATE> of the License
  5. to limit DNA Server Validations to 1 /day, check the latest of <ACTIVATION_DATE> or <VALIDATION_DATE> (if it exists) to see if more than XX hours have passed since the last event, typically 24 hours

If any of the checks fail, issue a WEB_Validate call. This will respond with a new DNA License (either a valid License or a disabled License).

If all checks pass, the Application can run.

 

WEB_VALIDATE POST Parameters

API 
"API": "WEB_VALIDATE"
DNA_KEY1 
"DNA_KEY1": "<encoded key1>"
DNA_KEY2 
"DNA_KEY2": "<encoded key2>"
PRODUCT_ID 
"PRODUCT_ID": "P0000000"

The DNA Product ID.
ACTIVATION_CODE 
"ACTIVATION_CODE": "XX012345ABCDEF"

License Code to be validated
DEVICE_ID
(Device Application)		 
"DEVICE_ID": "8c9c72719398508a"

When node-locking used, the device ID to be used
USERAGENT
(SAAS Application)		 
"USERAGENT": "<HTTP User Agent>"

The value of Request.ServerVariables["HTTP_USER_AGENT"]. Will be used to determine DNA_Platform and DNA_ComputerName.
USERAGENT
(Device Application)		 
"USERAGENT": "<device>"

The device OS platform used for display in the DNA Control Panel, from the following:

WINDOWS Windows 32-bit
WINDOWS64 Windows 64-bit
MACINTOSH Mac OSX 32-bit
MACINTOSH64 Mac OSX 64-bit
LINUX Linux
ANDROID Android Phone
IPHONE iPhone
IPAD iPad
COMPUTER_NAME
(Device Application)		 
"COMPUTER_NAME": "Joe-MAC"

If available, the assigned device name used for display in the License Manager and the DNA Control Panel
DATE 
"DATE": "22-12-07 15:37:47"

String representation of current date in any format. Used only to create / validate SIGNATURE
SIGNATURE 
"SIGNATURE": "eD9S9vqX7qFhpddJvQeLwRxfwHYByv5;fAMwb0LEnDE="

HMAC256 Signature for the Request

 

WEB_VALIDATE Request example for Device App in JSON format

            
             
            {
                "API": "WEB_VALIDATE", 
                "DNA_KEY1": "8c9c72719398508a", 
                "DNA_KEY2": "2044095b-6fa7-11ea-8949-000d3a126e14", 
                "PRODUCT_ID": "P0002964", 
                "ACTIVATION_CODE": "XX012345ABCDEF", 
                "DEVICE_ID":"8c9c72719398508a",
                "USERAGENT": "ANDROID", 
                "COMPUTER_NAME":"Joe-Samsung",
                "DATE":"22-12-07 15:37:47",
                "SIGNATURE": "eD9S9vqX7qFhpddJvQeLwRxfwHYByv5;fAMwb0LEnDE=" 
            }

 

WEB_VALIDATE Request example for SAAS App in JSON format

            
             
            { 
                "API": "WEB_VALIDATE", 
                "DNA_KEY1": "2044095b-6fa7-11ea-8949-000d3a126e14", 
                "DNA_KEY2": "2044095b-6fa7-11ea-8949-000d3a126e14", 
                "PRODUCT_ID": "P0002964", 
                "ACTIVATION_CODE": "XX012345ABCDEF", 
                "USERAGENT": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_11_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/80.0.3987.122 Safari/537.36", 
                "DATE":"22-12-07 15:37:47",
                "SIGNATURE": "eD9S9vqX7qFhpddJvQeLwRxfwHYByv5;fAMwb0LEnDE=" 
            }