Please take a look at the Home page before you read this documentation. A lot of useful information is currently there. See some of the users of SKGL.

Table of Content

Installing SKGL

In order to install SKGL, simply extract the library from the zip archive and add it as a reference to your project.

To add it as reference,

  1. First of all, open your project with Visual Studio.
  2. In the top menu, select Project > Add Reference...
  3. In the Add Reference window, select the Browse tab, and then open the SKGL Library (SKGL.dll)
  4. Now, SKGL API is successfully added to your project

Creating a Key

In order to create a key, please add the library as reference. Secondly, type the code below:

Dim CreateAKey As New SKGL.Generate ' creating an object
CreateAKey.secretPhase = "My$ecretPa$$W0rd" ' adding a password
TextBox1.Text = CreateAKey.doKey(30) ' generating a key; 30 is the time left.

or

SKGL.Generate CreateAKey = new SKGL.Generate(); // creating an object
CreateAKey.secretPhase = "My$ecretPa$$W0rd"; // adding password
textBox1.Text = CreateAKey.doKey(30); // generating a key; 30 is the time left.

Validate a Key

In order to validate a key, type the code below:

Dim ValidateAKey As New SKGL.Validate ' create an object
ValidateAKey.secretPhase = "My$ecretPa$$W0rd" ' the passsword
ValidateAKey.Key = "LMFME-OTQAF-JVBUP-OKFGP" ' enter a valid key
Console.WriteLine(ValidateAKey.IsValid) ' check whether the key has been modified or not

or

SKGL.Validate ValidateAKey = new SKGL.Validate();// create an object
ValidateAKey.secretPhase = "My$ecretPa$$W0rd"; // the passsword
ValidateAKey.Key = "LMFME-OTQAF-JVBUP-OKFGP"; // enter a valid key
Console.WriteLine(ValidateAKey.IsValid); // check whether the key has been modified or not

Security

In order to secure your project even better, please read through this section carefully!

It is recommended that you add the source code of SKGL API into your project, so that you can access all the functions diriectly, inside your project. (Please take a look at Integrate your application with SKGL API)

Otherwise, please merge your application with SKGL API using ILMerge,

If you have an opportunity to validate the serial keys online, using for instance ASP.NET, and if you want your software to be activated online, before the users get access to it, then, this solution would be even better than just storing the private key (password/secret phase) inside your own project. If you don't want to create your own, please take a look at http://serialkeymanager.com/!

As stated at http://skgl.codeplex.com/workitem/1359, it is a great tip to check if the target user uses your application before the creation date of the key (if he/she has changed their computer time, or if you explicitly assigned another creation time, when generated the key). The check might look as follows:

Dim validator As New SKGL.Validate ' declaring
validator.Key = "MIOYP-LXCBM-IMSZR-BUJMU" ' assing the key

'----validation process
If validator.IsValid And Not validator.IsExpired And validator.SetTime >= validator.DaysLeft Then
    '.... (the license is valid, not expired, may only be used after the creation date)
End If

If you have access internet, it is a good idea to check so that the end user has not changed the date in any way. Please see https://skgl.codeplex.com/discussions/472444 for a possible implementation in C#.

Advanced

Demo

Last edited Aug 17, 2014 at 8:33 PM by artemlos, version 47