LogicNP Software Knowledge Base And FAQ

CryptoLicensing For ActiveX :: HOWTO: Populate the License Management database with user data fields when generating licenses using the API

When using the Generator API to generate licenses, use the following code before calling the Generate method:
[C#]

Code:

// Get the "Data Fields" plugin
PropertiesPlugin plg = gen.GetUserDataPluginFromName("Data Fields") as PropertiesPlugin;

// Set it as the user-data plugin which the generator will use to retrieve the user-data to embed in the generated license
gen.SetUserDataPlugin(plg);

// populate the fields of the "Data Fields" plugin
plg.GetPropertyByName("Name").Value ="xyz";
plg.GetPropertyByName("Email").Value ="xyz";
plg.GetPropertyByName("Company").Value ="xyz";

// Alternately you can also do the following to set all fields at once...
// plg.SetUserData("first name=xxx;last name=yyy");

// Generate the license...
gen.Generate();

[VB.Net]

Code:

' Get the "Data Fields" plugin
Dim plg As PropertiesPlugin = TryCast(gen.GetUserDataPluginFromName("Data Fields"), PropertiesPlugin)

' Set it as the user-data plugin which the generator will use to retrieve the user-data to embed in the generated license
gen.SetUserDataPlugin(plg)

' populate the fields of the "Data Fields" plugin
plg.GetPropertyByName("Name").Value = "xyz"
plg.GetPropertyByName("Email").Value = "xyz"
plg.GetPropertyByName("Company").Value = "xyz"

' Alternately you can also do the following to set all fields at once...
' plg.SetUserData("first name=xxx;last name=yyy");

' Generate the license...
gen.Generate()

CryptoLicensing For MFC :: HOWTO: Populate the License Management database with user data fields when generating licenses using the API

When using the Generator API to generate licenses, use the following code before calling the Generate method:
[C#]

Code:

[VB.Net]

Code:

CryptoLicensing For .Net :: HOWTO: Populate the License Management database with user data fields when generating licenses using the API

When using the Generator API to generate licenses, use the following code before calling the Generate method:
[C#]

Code:

[VB.Net]

Code:

CryptoLicensing For MFC :: HOWTO: Create custom license service methods

You can create and add your own methods to the default set of license service methods. These custom methods can be called from your software using the CryptoLicense.QueryWebService method. The following demonstrates how to add a custom method which retrieves the number of activations remaining for a license:

In the App_Code/LicenseService.cs or App_Code/LicenseService.vb file of your license service, add following method to LicenseServiceClass :
[C#]

Code:

// The custom method must be marked with a "WebMethod" attribute and must have a return type of "string"

[WebMethod]

public string GetCurrentActivations(string licenseCode, string settingsFilePath)

{

string ret = "";

try

{

this.Initialise(settingsFilePath);

// Decrypt license code

licenseCode = this.Generator.DecryptString(licenseCode);

CryptoLicense lic = new CryptoLicense(licenseCode, this.Generator.GetValidationKey());

if (lic.ValidateSignature())

{

ret = this.GetNumberOfActivations(lic, "").ToString();

}

}

catch { }

// Return result in encrypted form for security.

return this.Generator.EncryptString(ret);

}

[VB.Net]

Code:

' The custom method must be marked with a "WebMethod" attribute and must have a return type of "string"
<WebMethod> _
Public Function GetCurrentActivations(licenseCode As String, settingsFilePath As String) As String

Dim ret As String = ""

Try

   Me.Initialise(settingsFilePath)

   ' Decrypt license code

   licenseCode = Me.Generator.DecryptString(licenseCode)

   Dim lic As New CryptoLicense(licenseCode, Me.Generator.GetValidationKey())

   If lic.ValidateSignature() Then

      ret = Me.GetNumberOfActivations(lic, "").ToString()

   End If

Catch
End Try

' Return result in encrypted form for security.
Return Me.Generator.EncryptString(ret)

End Function

You can then call this method from your software as follows:

Code:

// Standard setup...

CCryptoLicense* lic = new CCryptoLicense();

lic->SetValidationKey(_T("{validation key for your project"));

lic->SetLicenseCode(_T("{a license code generated with a 'Limit Machines To' setting}"));

lic->SetLicenseServiceURL(_T("{url of your license service}"));

// Call the custom "GetCurrentActivations" web method.

// The license code can be sent in encrypted form using EncryptString method for security
LPCTSTR paramNames[] = { _T("licenseCode"), _T("settingsFilePath") }; // params

CString licCode ;
licCode= lic->GetLicenseCode();

CString encrStr;
encrStr = lic->EncryptString(licCode);

LPCTSTR paramValues[] = {encrStr , _T("" )}; // param values

CString ret;
ret= lic->QueryWebService(_T("GetCurrentActivations"), paramNames, paramValues,2);

// Return value is encrypted, decrypt it and show the result
CString decrStr ;
decrStr = lic->DecryptString(ret);

CString result ;
result= _T("CurrentActivations = ")+ decrStr;

AfxMessageBox(result);

CryptoLicensing For ActiveX :: HOWTO: Create custom license service methods

Code:

// The custom method must be marked with a "WebMethod" attribute and must have a return type of "string"
[WebMethod]
public string GetCurrentActivations(string licenseCode, string settingsFilePath)
{

string ret = "";

try
{

this.Initialise(settingsFilePath);
// Decrypt license code
licenseCode = this.Generator.DecryptString(licenseCode);
CryptoLicense lic = new CryptoLicense(licenseCode, this.Generator.GetValidationKey());

if (lic.ValidateSignature())
{
ret = this.GetNumberOfActivations(lic, "").ToString();
}

}
catch { }

// Return result in encrypted form for security.
return this.Generator.EncryptString(ret);

}

[VB.Net]

Code:

You can then call this method from your software as follows:
[VB6]

Code:

' Standard setup...
lic.ValidationKey = "{validation key for your project"

lic.LicenseCode = "{a license code generated with a 'Limit Machines To' setting}"

lic.LicenseServiceURL = "{url of your license service}"

' Call the custom "GetCurrentActivations" web method.

' The license code can be sent in encrypted form using EncryptString method for security

Dim paramNames(1) As String
' params
paramNames(0) = "licenseCode"
paramNames(1) = "settingsFilePath" ' params

' param values
Dim paramValues(1) As String
paramValues(0) = lic.EncryptString(lic.LicenseCode)
paramValues(1) = ""

Dim ret As String
ret = lic.QueryWebService("GetCurrentActivations", paramNames, paramValues)

' Return value is encrypted, decrypt it and show the result
MsgBox ("CurrentActivations = " + lic.DecryptString(ret))

CryptoLicensing For ActiveX :: HOWTO: Avoid distribution of floating license code to multiple machines.

When using a customer-deployed floating license service, the typical scenario is to send the floating license code to the customer. The customer then distributes the license code internally to all the machines which will use your software. However, in case the customer has hundreds or thousands of machines on their network, this approach can be cumbersome or even unfeasible.

However, you can avoid the customer having to distribute the floating license code to multiple machine using these simple steps:

- Create a license.txt file (or use any other name you like) in the App_Data folder containing the floating license code.

- In the LicenseCode.cs (or .vb) file of your customer-deployed license service, add the following custom web service method to the LicenseServiceClass class:
[C#]

Code:

[WebMethod()]
public string GetLicenseCode()
{
using (StreamReader sr = new StreamReader(GetRealFilePath("%AppDomainAppPath%App_Data\\license.txt")))
{
return sr.ReadToEnd();
}
}

[VB.Net]

Code:

<WebMethod> _
Public Function GetLicenseCode() As String
Using sr As New StreamReader(GetRealFilePath("%AppDomainAppPath%App_Data\license.txt"))
Return sr.ReadToEnd()
End Using
End Function

When invoked, this web service method returns the license code stored in the license.txt file.

- In your actual app, call the above web service method as follows:
[VB6]

Code:

lic.LicenseCode = lic.QueryWebService("GetLicenseCode", Nothing, Nothing)

The above line will invoke the custom web service method and set the CryptoLicense.LicenseCode property to the returned license code.

- Now that the license code is loaded into the CryptoLicense instance, you can proceed to validate it as usual using the .Status property

Using this approach, the customer only needs to save the license code in one place (in the license.txt file in the App_Data folder) instead of having to distribute it to all the machines which need to use the floating license.

CryptoLicensing For MFC :: HOWTO: Avoid distribution of floating license code to multiple machines.

Code:

[WebMethod()]
public string GetLicenseCode()
{
using (StreamReader sr = new StreamReader(GetRealFilePath("%AppDomainAppPath%App_Data\\license.txt")))
{
return sr.ReadToEnd();
}
}

[VB.Net]

Code:

<WebMethod> _
Public Function GetLicenseCode() As String
Using sr As New StreamReader(GetRealFilePath("%AppDomainAppPath%App_Data\license.txt"))
Return sr.ReadToEnd()
End Using
End Function

When invoked, this web service method returns the license code stored in the license.txt file.

- In your actual app, call the above web service method as follows:

Code:

CString licStr;
licStr = lic.QueryWebService(_T("GetLicenseCode"), NULL, NULL,0);
lic.SetLicenseCode(licStr);

The above line will invoke the custom web service method and set the CCryptoLicense.SetLicenseCode() function to the returned license code.

- Now that the license code is loaded into the CryptoLicense instance, you can proceed to validate it as usual using the CCryptoLicense.GetStatus() function.

Using this approach, the customer only needs to save the license code in one place (in the license.txt file in the App_Data folder) instead of having to distribute it to all the machines which need to use the floating license.

CryptoLicensing For .Net :: HOWTO: Avoid distribution of floating license code to multiple machines.

Code:

[WebMethod()]
public string GetLicenseCode()
{
using (StreamReader sr = new StreamReader(GetRealFilePath("%AppDomainAppPath%App_Data\\license.txt")))
{
return sr.ReadToEnd();
}
}

[VB.Net]

Code:

<WebMethod> _
Public Function GetLicenseCode() As String
Using sr As New StreamReader(GetRealFilePath("%AppDomainAppPath%App_Data\license.txt"))
Return sr.ReadToEnd()
End Using
End Function

When invoked, this web service method returns the license code stored in the license.txt file.

- In your actual app, call the above web service method as follows:
[C#]

Code:

lic.LicenseCode = lic.QueryWebService("GetLicenseCode", new string[], new string[]);

[VB.Net]

Code:

lic.LicenseCode = lic.QueryWebService("GetLicenseCode", New String() {}, New String() {})

CryptoLicensing For MFC :: INFO: Access database and 64-bit machines

Microsoft does not provide a 64-bit version of its Access (JET) database, therefore it is not possible to use this database with CryptoLicensing on a 64-bit machine.

Please consider using another database which supports 64-bit machines like SQL Server, SQL Server CE, etc.

CryptoLicensing For ActiveX :: INFO: Access database and 64-bit machines

CryptoLicensing For .Net :: INFO: Access database and 64-bit machines

CryptoLicensing For ActiveX :: Unicode and x64 versions of the ocx files

The Unicode version of the ocx file is present in the 'Unicode' subfolder under the installation folder which is typically %Program Files%\LogicNP Software\CryptoLicensing For ActiveX 2012. Similarly the x64 version of the ocx file is present in the 'x64' sub-folder.

To use them, first register them using the regsvr32.exe utility present in these sub-folders.

CryptoLicensing For .Net :: HOWTO: Set license features when generating new licenses using the Generator API

Use the following code to set license features when generating new licenses using the Generator API:

[C#]

Code:

CryptoLicenseGenerator gen = new CryptoLicenseGenerator(@"c:\MyApp.netlicproj"); // Load license project

BitArray ba = new BitArray(3); // 3-bit array
ba[0]=true; // Feature 1 present
ba[1]=false;// Feature 2 not present
ba[2]=true;// Feature 3 present

gen.SetFeaturesEx(ba);

gen.Generate(); // The generated license will have the above specified features

[VB.Net]

Code:

Dim gen As CryptoLicenseGenerator = New CryptoLicenseGenerator("c:\MyApp.netlicproj") ' Load license project

Dim ba As BitArray = New BitArray(3) ' 3-bit array
ba(0) = True ' Feature 1 present
ba(1) = False ' Feature 2 not present
ba(2) = True ' Feature 3 present

gen.SetFeaturesEx(ba)

gen.Generate() ' The generated license will have the above specified features Each license can have upto 2040 bits/features.

CryptoLicensing For ActiveX :: HOWTO: Limit serial validations to a certain number of machines.

By default, a serial code can be validated from any number of machines. You can change this behavior by setting the LicenseService.SerialValidationLimit property in the App_Code/LicenseService.cs/vb file as follows:

Code:

public class LicenseServiceClass : LogicNP.CryptoLicensing.LicenseService
{
public LicenseServiceClass()
{
...
...
this.SerialValidationLimit = SerialValidationLimit.FromProfile_MaxActivationsSetting;
}
}

Code:

Public Class LicenseServiceClass
Inherits LogicNP.CryptoLicensing.LicenseService

Public Sub New()
...
...
Me.SerialValidationLimit = SerialValidationLimit.FromProfile_MaxActivationsSetting
End Sub

End Class

The LicenseService.SerialValidationLimit property can have the following enumeration values:

Explicit_SameAsMaxSerialValidations: Specifies that the value of the LicenseService.MaxSerialValidations property specifies the maximum number of machines on which the serial can be validated.

FromProfile_MaxActivationsSetting: Specifies that the value of the 'MaxActivations' setting stored in the profile specifies the maximum number of machines on which the serial can be validated.

FromDatabaseLicense_MaxActivationsSetting: Specifies that the value of the 'MaxActivations' setting stored in the database license specifies the maximum number of machines on which the serial can be validated. This mode requires that the LicenseService.SerialValidationMode property be set to UseLicenseDatabaseFirst or UseLicenseDatabaseOnly.

CryptoLicensing For MFC :: HOWTO: Limit serial validations to a certain number of machines.

Code: