BarbezDotEu.License.Generation 2.0.0

Generic "Resulting-Sum" License Key Generator Library

A generator for human-friendly, readable license keys and serial numbers by www.barbez.eu.

Produces license keys you don't mind spelling out loud to another person.

The Barbez.eu license key generator is ideal for all your license key or serial number generation needs, producing keys or serials that are easy to read out loud one human to another. Yet, the algorithm is quick enough to generate a decent amount of them in a short period of time.

Table of Contents

0. NuGet Packages and Demo app
1. Features
2. Custom Resulting-Sum Algorithm
3. Performance
4. Stats
5. Graphs

NuGet Packages and Demo app

Get the generator NuGet package from https://www.nuget.org/packages/BarbezDotEu.License.Generation/ or use

Install-Package BarbezDotEu.License.Generation -Version 1.2.1

Get the verifier NuGet package from https://www.nuget.org/packages/BarbezDotEu.License.Verification/ or use

Install-Package BarbezDotEu.License.Verification -Version 1.2.1

A demo project using this generic library can be found at https://github.com/hannesbarbez/BarbezDotEu.License.Generator.WinForms.

Features

• Full multithreading, thanks to .NET Core’s TPL (Task Parallel Library);
• Custom “resulting-sum” algorithm to generate a bunch of unique license keys quickly;
• On-the-fly license key validator;
• Decoupling, e.g. strict separation between UI and logic;
• Generated license keys that are easy for people to spell out loud;
• Native support for async/await.

Custom Resulting-Sum Algorithm

Lacking academic knowledge on serial number or license key generation algos, the generator algorithm is my own idea, so I’ve decided to dub it “resulting-sum”. More info on the exact workings to follow, for now the source code should suffice to explain its inner workings.

Performance

After running a couple of tests on an AMD Ryzen 1600 (6 cores, 12 threads) based machine, I compiled a short table with the results.

On this hardware, a ResultingSum of 68 takes Y time to render/generate X number of unique keys. The sweet-spots are marked in bold in the below table.

Results will differ for other ResultingSum values. For a value of 68, 30 000 unique keys are generated in under 9 seconds.

The going gets tougher when generating 150 000 unique keys in exactly 4 minutes. Lawd.

Stats

Note: these stats are from the initial version of the NuGet package. Newer versions of the package are quicker, yet the overal trend of the graphs remains.

A "resulting sum" of 68 takes Y time to render/generate X number of unique keys on a Ryzen 1600 based machine.

Graphs

Note: these stats are from the initial version of the NuGet package. Newer versions of the package are quicker, yet the overal trend of the graphs remains.

BarbezDotEu.License.Generation

Contents

• KeyGenerator
  • #ctor(resultingSum,divider)
  • EXCEPTION
  • GenerateKeys(numberOfKeys,excludedKeys)

<a name='T-BarbezDotEu-License-Generation-KeyGenerator'></a>

KeyGenerator type

BarbezDotEu.License.Generation

Basic key generator class.

<a name='M-BarbezDotEu-License-Generation-KeyGenerator-#ctor-System-Int32,System-String-'></a>

#ctor(resultingSum,divider) constructor

Constructs a new KeyGenerator.

Parameters

<a name='F-BarbezDotEu-License-Generation-KeyGenerator-EXCEPTION'></a>

EXCEPTION constants

One or more parameters are invalid. NULL, negative, empty or default values are not valid parameters.

<a name='M-BarbezDotEu-License-Generation-KeyGenerator-GenerateKeys-System-UInt32,System-String[]-'></a>

GenerateKeys(numberOfKeys,excludedKeys) method

Generates a number of license keys.

Returns

The generated license keys.

Parameters

BarbezDotEu.License.Verification

Contents

• KeyVerificator
  • #ctor(resultingSum,divider)
  • EXCEPTION
  • ValidKey()
  • ValidateSegment(segment)
  • VerifyKey()
  • VerifyKey(key)

<a name='T-BarbezDotEu-License-Verification-KeyVerificator'></a>

KeyVerificator type

BarbezDotEu.License.Verification

Basic key verifier class.

<a name='M-BarbezDotEu-License-Verification-KeyVerificator-#ctor-System-Int32,System-String-'></a>

#ctor(resultingSum,divider) constructor

Constructs a new basic key verifier (verificator, lat.)

Parameters

<a name='F-BarbezDotEu-License-Verification-KeyVerificator-EXCEPTION'></a>

EXCEPTION constants

One or more parameters are invalid. NULL, negative, empty or default values are not valid parameters.

<a name='M-BarbezDotEu-License-Verification-KeyVerificator-ValidKey-System-String,System-String,System-String,System-String,System-String-'></a>

ValidKey() method

Checks if inputted key is valid

Returns

True if valid, false if invalid.

Parameters

This method has no parameters.

<a name='M-BarbezDotEu-License-Verification-KeyVerificator-ValidateSegment-System-String-'></a>

ValidateSegment(segment) method

Checks if a segment valid.

Returns

True if valid, false if invalid.

Parameters

<a name='M-BarbezDotEu-License-Verification-KeyVerificator-VerifyKey-System-String,System-String,System-String,System-String,System-String-'></a>

VerifyKey() method

Checks if a key is valid as well as all of its segments.

Returns

True if the key is valid; false otherwise.

Parameters

This method has no parameters.

<a name='M-BarbezDotEu-License-Verification-KeyVerificator-VerifyKey-System-String-'></a>

VerifyKey(key) method

Verifies a given key.

Returns

TRUE if the key is valid. False, otherwise.

Parameters

Mild disclaimer

The code in this repository was written for and used within a variety of Barbez.eu apps distributed via Amazon.com in the late 2010's.

If you're looking for a license key generator that is "uncrackable", this is one is not for you. You can however consider using it as a base for your own license key generator, perhaps.

Author

www.barbez.eu