A newer version of this documentation is available.

License

The license section controls the usage of Net iD Client.

[License]
Name=DEMO ONLY 2020-09-30
Company=Pointsharp AB
Value=DC5H-gQiZ-bXpu-LLCT-x9qH-1lB9
Activate=
AllowIssuer=
AllowSubject=
:Path=

Name

The license name is always present and should contain a description of the license holder. The name value may include an end date and also information that limits the use of Net iD Client.

Changing the Name value will make the license invalid.

End date

[License]
Name=DEMO ONLY 2020-09-30

Under development

The name UNDER DEVELOPMENT is used for developer licenses. This license type removes some security restrictions for trace, and allows for writing sensitive information to trace. Never use this license type in production environments. It is for debugging and testing use only.

[License]
Name=UNDER DEVELOPMENT

Limited

A limited license includes two DWORD values within brackets which specifies the allowed components and tokens.

[License]
Name=Limited [FFFFFFFF,FFFFFFFF]

The first DWORD contains a bitmask specifying the allowed components.

First DWORD

#define COMPONENT_MAIN           0
#define COMPONENT_PKCS11         1
#define COMPONENT_CSP            2
#define COMPONENT_KSP            3
#define COMPONENT_MD             4
#define COMPONENT_RTK            5
#define COMPONENT_PLUGIN         6
#define COMPONENT_PLUGIN_NPAPI   7
#define COMPONENT_PLUGIN_ACTIVEX 8
#define COMPONENT_PLUGIN_JNI     9
#define COMPONENT_PLUGIN_IO      10
#define COMPONENT_SSO_PKCS11     11
#define COMPONENT_SSO_CACHE      12
#define COMPONENT_SSO_CSP        13
#define COMPONENT_SSO_KSP        14
#define COMPONENT_SSO_RTK        15
#define COMPONENT_SSO_PLUGIN     16
#define COMPONENT_CP             17
#define COMPONENT_WATCH          18
#define COMPONENT_EVENT          19
#define COMPONENT_CONNECT        20
#define COMPONENT_SHELL          21
#define COMPONENT_TRACE          22
#define COMPONENT_REPORT         23
#define COMPONENT_PCSC           24
#define COMPONENT_TS_VC          25
#define COMPONENT_SCS            26

The second DWORD contains a bitmask specifying the allowed tokens.

Second DWORD

#define COMPONENT_TOKEN_CARD     0
#define COMPONENT_TOKEN_VSC      1
#define COMPONENT_TOKEN_CSP      2
#define COMPONENT_TOKEN_TPM      3
#define COMPONENT_TOKEN_LOCAL    4
#define COMPONENT_TOKEN_REMOTE   5
#define COMPONENT_RESERVED_1     6
#define COMPONENT_RESERVED_2     7

Also, the smart card implementations can be specified for bit 8—32.

#define CARD_SETEC_SETCOS     0
#define CARD_FINEID           1
#define CARD_SIEMENS_CARDOS   2
#define CARD_GEMPLUS          3
#define CARD_DOTNET           4
#define CARD_IASECC           5
#define CARD_PIV              6
#define CARD_YUBIKEY          7
#define CARD_BUYPASS          8
#define CARD_SND              9
#define CARD_MYEID            10
#define CARD_ESTEID           11
#define CARD_ACTIVID          12
#define CARD_JCOP             13
#define CARD_FEITIAN          14
#define CARD_CRESCENDO        15
#define CARD_IDENTIV          16

Company

The licensing company is always present and should contain the company name of the license holder.

Changing the Company value will make the license invalid.

[License]
Company=Pointsharp AB

Value

The license value is the generated license, and it is connected to the license name or company.

[License]
Value=DC5H-gQiZ-bXpu-LLCT-x9qH-1lB9

Activate

The Activate parameter will in the future be used to tell the server that should be called, to activate the license. Currently not used.

[License]
Activate=

AllowIssuer, AllowSubject

The AllowIssuer and AllowSubject values limit the certificates that are used with Net iD Client. These values are not protected by the license value but can still be used when using a static configuration package.

[License]
AllowIssuer=
AllowSubject=

Allow issuers with specified CN.

Allow issuers with these specified common names.

[License]
AllowIssuer=CN=SecMaker*;CN=Pointsharp*

Path

The full path to a file containing the license information:

Name
Company, and
Value.

The Path property has precedence if Path and Name, Company, and Value are all set.

[License]
Path=<path>

Values

<path>: The full path to the file containing the license information. Or the registry key to where the license entries are found. See examples below.

You can use environment variables when you set the path. But remember that environment variables can be different for users and systems and can have unwanted effects on the configuration. Thus, Pointsharp does not recommend using environment variables to set configuration values.

Examples

Example 1. Reading license information from file.

Path property:

[License]
Path=/tmp/iidlicense.lic

License information file iidlicense.lic:

[License]
Name=Net iD Client
Company=Company Inc.
Value=g1DZ-QNXp-ObSs-yloD-VAEQ-KaKc

Example 2. Reading license information from registry.

Path property:

[License]
Path=HKLM\<MyApp>\NetiD

Registry information:

[HKLM\SOFTWARE\<MyApp>\NetiD\License]
"Name"="Net iD Client"
"Company"="Company Inc."
"Value"="g1DZ-QNXp-ObSs-yloD-VAEQ-KaKc"