Activation Server 5

Navigation: Activation Server > Tutorial Activation Server > Keys

Create Keys by an external applications

External applications like a shop system or ERP / CRM system can create any type of keys using an http request to the Activation Server 5.

You should only create keys after specifying an IP address to limit key generation for a specific server, limit the number of keys which can be generated per minute / hour and additionally use a password - details see security settings.

You can create different types of keys:

•Serial Number key

•Unlock Key - e.g. by activation through a web page

•Activation Keys - e.g. prolong a trial version or add additional network licenses

The URL consists of 2 parts:

Part 1 - URL to the server and web page - e.g. http://www.registerserver.net/lptest/lpweb/KeyGenerator.aspx?

Part 2 - Parameters to specify the key details

* = required parameters

Parameter	Values	Example	Remark
projectname *	project name from the project template	demo-easygo
entrykey
instcode
instcodetype
requesttype *	1 = activate module, 2 = create a Serial Number or Unlock Key, 3 = create an Activation Key	2	serial number: Must be 2
moduleid *	module ID from the project template	AHD001
customername	customer name assigned to the key	AllAbout Software
email	E-mail address assigned to the key
oemname
allkeys	true / false	true
additionaldays
additionallicenses	0-2147483647	1	value for network license. For single user it should be set to 1. Only use this value for Serial Numbers
externalgroup
externalid
reseller
numberofkeys	number of keys to create	1
maxtries	maximum key / ID usage	2	number of computers the key can be used
stroeindb	true / false Default: false	true	store the key= true or only create the key = false
islocked	true / false Default: false	false	lock a key so that it only can be used once it was unlocked
additionalKeyValue	0-2147483647	1	value for network license. For single user it should be set to 1. Only use this value for Activation Keys. The value will be added to an existing value in the license file
additionalKeyValueFixed	true Default: false	true	true = overwrite existing value in the license file using the value from additionalKeyValue false = add to the existing value in the license file using the value from additionalKeyValue
expiryDate	YYYY-MM-DD	2013-01-25	Expiry Date
numberOfDays	0-2147483647	10	value for days. Starts when the user applies the key. The value will be added to an existing value in the license file
numberOfDaysFixed	true Default: false	true	true = overwrite existing value in the license file using the value from numberOfDays false = add to the existing value in the license file using the value from numberOfDays
onlineValidationRequired	true / false	false	serial number: Must be false
demoversion	true / false	false
regularLicenseChecks	true / false
unlimitInstallations	true / false	true	serial number: Must be true
activationState	0 = none, 1 = required, 2 = done, 3 = erroneous		serial number: Must be 1
isSerianumber	true / false	true	serial number: Must be true
typeofrequest *	1 = check key 2 = activate 3 = acknowledge 4 = check licence 5 = deactivate licence 6 = send customer info 21 = serial number 22 = product deactivated 31 = initialize licence	2	serial number: Must be 2 Activation Key: Must be 3
password	Password - see security settings	ycnsjldsd78z9h	highly recommended to use a password

You have to use the method GET (not POST) for the http request

Example URL

The URL below creates a Serial Number

https://www.registerserver.net/lptest/lpweb/KeyGenerator.aspx?projectname=demo-easygo-40&entrykey=&instcodetype=&instcode=&requesttype=2&moduleid=QHD001&customername=AllAbout%20Softtware%20Inc&email=&oemname=&allkeys=true&additionaldays=&additionallicenses=1&externalgroup=&externalid=&reseller=&numberofkeys=1&maxtries=&storeindb=true&islocked=&additionalKeyValue=&additionalKeyValueFixed=&expiryDate=&numberOfDays=&numberOfDaysFixed=&onlineValidationRequired=&demoversion=&regularLicenseChecks=&unlimitInstallations=true&activationState=1&isSerialnumber=true&typeofrequest=2

The URL creates an Unlock Key

https://registerserver.net/lptest/lpweb/KeyGenerator.aspx?projectname=demo-easygo-40&entrykey=LNGEG-5IPc6-9E7Im-3tQ8X-MQU5k-6ii4S&instcode=170D9F7C;E1266C60;;CB433287;;;;;;;;;&requesttype=2&moduleid=QHD001&customername=Smart Inc.&email=tom.hanks@smartinc.com&oemname=mycompany&allkeys=true&password=ycnsjldsd78z9h

More details about Unlock Key generation

The URL creates an Activation Key

https://www.registerserver.net/lptest/lpweb/KeyGenerator.aspx?projectname=demo-easygo-40&entrykey=&instcodetype=&instcode=&requesttype=3&moduleid=QHD001&customername=AllAbout%20Softtware%20Inc&email=&oemname=&allkeys=true&additionaldays=&additionallicenses=1&externalgroup=&externalid=&reseller=&numberofkeys=1&maxtries=&storeindb=true&islocked=&additionalKeyValue=&additionalKeyValueFixed=&expiryDate=&numberOfDays=&numberOfDaysFixed=&onlineValidationRequired=on&demoversion=no&regularLicenseChecks=&unlimitInstallations=true&activationState=done&isSerialnumber=false&typeofrequest=3&password=ycnsjldsd78z9h

URL encoding

Umlauts and special characters in text values have to be encoded (e.g. replace a space with %20). Most developer tools automatically do the encoding.

Example how to encode a URL

Help to create the URL

Use the link below. It provides a web page to type in the necessary values and then creates the URL.

https://www.registerserver.net/lptest/keygeneratordemo.htm