Tag

Level, [min,max]

Description

Comment

<LicenceProtector> *

0 [1,1]

Surrounds the whole project configuration

<Default> *

1 [1,1]

Surrounds the global project definitions.

<ProjectName>

2 [0,1]

Name of the project. If this item is empty, the filename of the project file is used. The project name is used to administrate the numbers of projects within the Licence Generator, The project name should be unique.

If no explicit project is set in a Web Activation Call this ProjectName is used. So be sure to use the same name in the definition of your Web Activation configuration. 

Example:

Demo project

<ProjectSecureKey> *

2 [1,1]

The PSK is used to encode and decode the licence files of a project.

Please use a minimum of 6 characters, 15 and more are recommended. Note: The PSK must never be modified after having been applied, because otherwise you would not be able to read your licence files.

Example:

What a beautiful morning

<SecurityLevel>

2 [1,1]

Possible values are BASIC and ADVANCED. In advanced mode the ReadKey and WriteKey (or ReadKeyProtected and WriteKeyProtected) are used.

Default is BASIC

<WriteKey>

2 [0,1]

The Write Key is used in projects with security level ADVANCED to write the licence file. It has to be created using the function “File, Create Project Keys” in the Licence Generator and has to match its Read Key.

It may be longer than 255 characters

Never use it together with <WriteKeyProtected> in one Project file.

<WriteKeyProtected>

2 [0,1]

This is the Write Key that has to be decrypted using the Project Master Key.

Never use it together with <WriteKey> in one Project file.

<ReadKey>

2 [0,1]

The Read Key is used in projects with security level ADVANCED to open the licence file. It has to be created using the function “File, Create Project Keys” in the Licence Generator and has to match its Write Key.

Never use it together with <ReadKeyProtected> in one Project file.

<ReadKeyProtected>

2 [0,1]

This is the Read Key that has to be decrypted using the Project Master Key.

Never use it together with <ReadKey> in one Project file.

<CopyProtection> (D)

2 [0,1]

The default CopyProtection used in this project:

0 = None
1 = Copy Protection Volume ID

2 = Copy Protection MAC Address

3 = Copy Protection Hostname

4..n see chapter copy protection for the latest options

Example:

2

<Manufacturers> (D)

2 [0,1]

All companies which should be listed in the field Manufacturer in the  Licence Generator.

The first entry is the default value. Multiple entries have to be separated by a semicolon

Example:

Mirage Computer Systems GmbH;Another Company;And the third Company

<NextLicFileKey>

2 [0,1]

Next Licence File ID which is assigned to the licence file. If you create licences at different locations, we recommend that you use an own range of values for each location. Example: use 20000 for location 2 as starting value. The value range is between 1 and 2147483647

This value is automatically increased if a licence file is created by a Licence Protector Generator. Ensure to have write-access to the project file.

<NameLicenceFile> (D)

2 [0,1]

Name of the licence file which is used as default name when saving the file

Example:

MyApplication

<CustomerName> (D)

2 [0,1]

Default value for the Customer information in the licence file. This value is overwritten if interactively changed in Licence Generator.

Example:

Evaluation

<TagValue>

2 [0,1]

Special string value for the whole licence file. There is also a TAG value per module available

Individual information can be stored here

<AllowSetVal>

2 [0,1]

Controls whether this Licence file may be altered with SetVal calls

Default is yes

<DefaultDiffPct>

2 [0,1]

Difference percentage used in Concurrent user modules. This value is used in a module if not explicitly set with <DiffPct>. It not set a built in default value is used

Can be changed with a DLL function during the programme runs

<TamperDetection>

2 [0,1]

Switch to turn on or off the detection of manipulation of the licence file.

Default is no

<TamperDetectionMode>

2 [0,1]

Sets the mode of the detection of manipulation:

off, auto, manual

Default is off

<TamperDetectionGraceTimes>

2 [0,1]

Allowed negative difference between the Run Numbers of the licence file and the local Registry

Default is 0

<WebServiceURL>

2 [0,1]

The URL used to reach the Web Activation Service.

Example:

http://www.lptest/lpweb/lpws.asmx

<AllowChangeWASURL>

2 [0,1]

Controls if the set URL to the Web Activation Service can be manually changed by the user.

Default is no

<ShowWAStartPage>

2 [0,1]

If Web Activation calls are used this setting controls if the Web Activation client start page is shown

Default is true

<ShowWAProgressPage>

2 [0,1]

If Web Activation calls are used this setting controls if the Web Activation client progress page is shown

Default is true

<ShowWAResultPage>

2 [0,1]

If Web Activation calls are used this setting controls if the Web Activation client result page is shown

Default is true

<LicenceVerification>

2 [0,1]

Sets the mode of the online licence verification. Possible values are:

Off, on, frozen and deactivated

That mode controls the behaviour of the CheckLicence call.

Default is off

<EndVerification>

2 [0,1]

Controls on which date the ongoing Licence Verification is stopped. A value of +10 would calculate 10 days from now,

Absolute dates can also be used.

Default is open end.

<LicenceModules>

1 [1,1]

Surrounds all modules inside this project

<Module>

2 [1,n]

Surrounds a module definition

<ModuleID>

3 [1,1]

Unique number for each module. May occur only 1 time per project file. It is used as a parameter in most DLL calls.

Format of the ModuleID is up to 6 characters containing only characters A-Z and digits 0 to 9. The ModuleID is case insensitive.

Example:

D1001

<ModuleName>

3 [1,1]

Name of the module. This name is used in Licence Viewer and should be self-descriptive

Example:

ERP-Module

<ModuleType>

3 [1,1]

Type of a module. Explained in detail below
U or 1 = Licence per user
S or 2 = Licence per Computer
C or 3 = Counter Module
Y or 4 = Yes/No Module
I or 5 = ITEM Counter
R or 6 = Concurrent user licence

Example:

Y

<Value> (D)

3 [1,1]

Default for number of licences in the module. A module of type 4 (Yes/No) is set to yes or no.

Example:

10 (e.g. user licences in a type 1 module)

Yes (in a type 4 module)

<Days> (D)

3 [0,1]

Default for Number of days in the module. This value starts to count after the first Validate to that module („Module initialisation“)

Example:

10

10 days after the first Validate()-call this module will expire.

<ValidUntilDay> (D)

3 [0,1]

Default value. Explicitly set or calculated date of expiry of this module.

The difference between a fix date set with <ValidUntilDay> to 30 days from today to a value 30 in the field <Days> is that with <ValidUntilDay> the module will expire in 30 days regardless when the software will be installed. When 30 is set in <Days> then the module will expire 30 days after the module is first Validated.

Use an explicit date in the format set in your Windows settings e.g. 5/16/2005 or use a term +X to calculate the date as today plus X days. E.g. +30 calculates a date 30 days from today

<Demoversion> (D)

3 [0,1]

Default value. A yes or no value to set the mode of this module

Example:

Yes

<WebActivation> (D)

3 [0,1]

Default value for Web Activation. Valid values are:

0 or none

1 or required

2 or done

3 or erroneous

See Web Activation for further details.

Example:

Required

<TagValueModule> (D)

3 [0,1]

Default value. Special value to detect a software hack - for details see developer documentation

<LoadAsDefault>

3 [0,1]

A yes/no value to control whether this module is shown when the project is loaded in Licence Generator or not. With this feature you can load all modules normally needed in a project automatically

<AllowDeactivate>

3 [0,1]

A yes/no value that is only applicable for module type 1, 2 and 5. Defines, whether a user or ITEM can be deactivated in order to free a licence.

<CheckIntervall>

3 [0,1]

Amount in seconds after which another automatic Validate-call in a concurrent user module is done. It not set a built in default value is used

This value is automatically set by the Licence Generator and depends on the amount of licences.

<DiffPct>

3 [0,1]

The tolerance in percent that is allowed for a client to do an automatic validate at a concurrent user module. It not set a built in default value is used

<ForceOnlineCheck>

3 [0,1]

Only useful for key generation in the Automatic Licence Generator. A yes/no value to control whether generated keys should be checked with the Web Activation server

<AbsoluteLics>

3 [0,1]

A Yes/No Value. Only useful for key generation in the Automatic Licence Generator. If set to Yes the number of licences in Value is not added to the present number of licences in the licence file, it overwrites the number of licences with the absolute value.

This value is overridden if the value <AbsoluteLics> is set in the product configuration file or in the order file

Example: In a licence file there are 5 licences for a Module X. A key for 3 licences with AbsoluteLics set to no will increase the number of licences to a total of 8 licences. The same key with AbsoluteLics set to yes will set the total number of licences to 3.

Default is not set.

<AbsoluteDays>

3 [0,1]

A Yes/No Value. Only useful for key generation in the Automatic Licence Generator. If set to Yes the number of days in Value is not added to the present number of days in the licence file, it overwrites the number of days with the absolute value.

This value is overridden if the value <AbsoluteDays> is set in the product configuration file or in the order file

If set to yes a key will set the maximum number of days to <Days> unattached if there are already existing number of days in the licence file.

Default is not set.