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 License 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 license 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 license 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. Recommended is ADVANCED. See details.

<WriteKey>

2 [0,1]

The Write Key is used in projects with security level ADVANCED to write the license file. It has to be created using the function “File, Create Project Keys” in the License 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 license file. It has to be created using the function “File, Create Project Keys” in the License 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 license File ID which is assigned to the license file. If you create licenses 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 license 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 license 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 license file. This value is overwritten if interactively changed in License Generator.

Example:

Evaluation

<TagValue>

2 [0,1]

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

Individual information can be stored here

<AllowSetVal>

2 [0,1]

Controls whether this license file may be altered with SetVal calls

Default is yes. See also command SetVal

<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

See also command DiffPct

<CheckInterval>

2 [0,1]

Sets the interval of the concurrent user heartbeat in seconds. Default value = -1 (automatic calculation depending on number of licenses)

See also command SetCheckInterval

<ConcurrentUserLevel>

2 [0,1]

Sets the concurrent user level 0 = Heartbeat, 1 = Light - Details

See also command ConcurrentUserLevel

<TamperDetection>

2 [0,1]

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

Default is no. See also command TamperDetection

<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 license file and the local Registry

Default is 0

<WebServiceURL>

2 [0,1]

The URL used to reach the Web Activation Service. Details

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.  See also command ShowWAStartPage

<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.  See also command ShowWAProgressPage

<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.  See also command ShowWAResultPage

<LicenceVerification>

2 [0,1]

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

off = turned off

on = Ongoing Verification

frozen = License is locked

deactivated = Verification is deactivated

That mode controls the behaviour of the CheckLicence call. Details Regular Online Checks

Default is off.  See also command LicenceVerification

<EndVerification>

2 [0,1]

Controls on which date the ongoing license 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 License Viewer and should be self-descriptive

Example:

ERP-Module

<ModuleType>

3 [1,1]

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

Example:

Y

<Value> (D)

3 [1,1]

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

Example:

10 (e.g. user licenses 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 License Generator or not. With this feature you can load all modules normally needed in a project automatically

<IsSerial>

3 [0,1]

Defines, if a module is a Serial Number

Valid values are:

yes

no

Details see - define Serial Number

<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 license.

<ForceOnlineCheck>

3 [0,1]

Only useful for key generation in the Automatic License 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 License Generator. If set to Yes the number of licenses in Value is not added to the present number of licenses in the license file, it overwrites the number of licenses 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 license file there are 5 licenses for a Module X. A key for 3 licenses with AbsoluteLics set to no will increase the number of licenses to a total of 8 licenses. The same key with AbsoluteLics set to yes will set the total number of licenses to 3.

Default is not set.

<AbsoluteDays>

3 [0,1]

A Yes/No value. Only useful for key generation in the Automatic License Generator. If set to Yes the number of days in Value is not added to the present number of days in the license 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 license file.

Default is not set.

<configs>

1 [1,1]

Surrounds all configuration values

Store configuration values and data. See details in the chapter Store data in the license file

<config>

2 [1,n]

Surrounds a configuration definition

<name>

3 [1,1]

Unique name of a configuration value

A unique name to store a value

Example:

BasicConfiguration

<visible>

3 [0,1]

A Yes/No value.Defines, if the config value is visible in the License Viewer

[1,1]

Configuration value. Can be any ASCII Text

This is a text