starred/Standard.Licensing
1
0
Fork 0
mirror of https://github.com/junian/Standard.Licensing.git synced 2026-04-25 05:45:51 +03:00
Code Issues 24 Projects Releases Packages Wiki Activity

[PR #16] [CLOSED] Add License Keys Using .Net Cryptography APIs to project #43

New issue
Closed
opened 2026-02-26 02:30:18 +03:00 by kerem · 0 comments
kerem commented 2026-02-26 02:30:18 +03:00
Owner
Copy link

📋 Pull Request Information

Original PR: https://github.com/junian/Standard.Licensing/pull/16
Author: @ConnerPhillis
Created: 4/30/2020
Status: ❌ Closed

Base: master ← Head: master

📝 Commits (2)

📊 Changes

24 files changed (+1942 additions, -2 deletions)

View changed files

➕ src/Standard.Licensing.LicenseKey.Tests/Extensions/TestExtensions.cs (+6 -0)
➕ src/Standard.Licensing.LicenseKey.Tests/KeyGeneration/StandardLicenseFactoryTests.cs (+82 -0)
➕ src/Standard.Licensing.LicenseKey.Tests/KeyValidation/StandardLicenseValidatorTests.cs (+544 -0)
➕ src/Standard.Licensing.LicenseKey.Tests/LicenseKeyTests.cs (+36 -0)
➕ src/Standard.Licensing.LicenseKey.Tests/LifecycleTests.cs (+93 -0)
➕ src/Standard.Licensing.LicenseKey.Tests/SignedLicenseTests.cs (+34 -0)
➕ src/Standard.Licensing.LicenseKey.Tests/Standard.Licensing.LicenseKey.csproj (+22 -0)
➕ src/Standard.Licensing.LicenseKey.Tests/TestLicenseKeyManager.cs (+40 -0)
➕ src/Standard.Licensing.LicenseKey.Tests/TestLicenses/SimpleTestLicense.cs (+34 -0)
➕ src/Standard.Licensing.LicenseKey/Internals/Extensions/JsonExtensions.cs (+23 -0)
➕ src/Standard.Licensing.LicenseKey/Jwt/JwtTokenManager.cs (+90 -0)
➕ src/Standard.Licensing.LicenseKey/KeyGeneration/ILicenseFactory.cs (+49 -0)
➕ src/Standard.Licensing.LicenseKey/KeyGeneration/StandardLicenseFactory.cs (+49 -0)
➕ src/Standard.Licensing.LicenseKey/KeyValidation/ILicenseValidator.cs (+181 -0)
➕ src/Standard.Licensing.LicenseKey/KeyValidation/LicenseValidationResults.cs (+14 -0)
➕ src/Standard.Licensing.LicenseKey/KeyValidation/StandardLicenseValidator.cs (+234 -0)
➕ src/Standard.Licensing.LicenseKey/LicenseKey.cs (+60 -0)
➕ src/Standard.Licensing.LicenseKey/LicenseKeyManager.cs (+28 -0)
➕ src/Standard.Licensing.LicenseKey/LicenseSigningParameters.cs (+126 -0)
➕ src/Standard.Licensing.LicenseKey/LicenseType.cs (+10 -0)

...and 4 more files

📄 Description

This code is a massive effort I've been working on in spare time over the last few months for a school project. There is a readme attached in the PR detailing the new API that I have created for this repository.

Here's the contents of the Readme as they exist now.

Usage

Creating License Signing Parameters

StandardLicensing License Keys uses .Net's Cryptology APIs to create and sign the license keys it generates, more specifically, the RsaSsaPssSha256 algorithm. Keys can be any length in bits that the RSA algorithm permits (512, 1024, 3096, etc...). The default is 2048 bits.

Generating New License Parameters

You can generate new keys for license signing by instantiating the LicenseSigningParameters with no arguments or one argument representing your desired key size.

// optionally you can pass the key size, defaults to 2048 bits
using var licenseParameters = new LicenseSigningParameters();

Saving License Parameters

If you wish to store your public key in your application or simply wish to use the same private key for every new license you generate you will have to save your license parameters. This can be accomplished easily with the Export and Import methods which also support asynchronous code.

licenseParameters.Export("keys.txt");
// then, when you need the keys again
using var signingParameters = LicenseSigningParameters.Import("keys.txt");

Creating the License Generator

StandardLicensing License Keys supports a base set of fields for licenses, but also has functionality to support further configuration through generics. This allows you to specify further strongly typed license details in the KeyData property.

public class TestLicense 
{
    public int MaxUsers { get; set; }

    public string IssuedTo { get; set; }
}

Using the Fluent API

StandardLicensing License Keys also supports a fluent API to configure all of its license properties.

using var signingParameters = new LicenseSigningParameters();

var licenseInformation = new TestLicense
{
    MaxUsers = 10000,
    IssuedTo = "Some Random User"
};

var signedLicense = LicenseKeyManager.Create(licenseInformation)
    .WithName("Test License")
    .WithType(LicenseType.Enterprise)
    .WithActivationDate(DateTime.UtcNow.AddDays(1))
    .WithExpirationDate(DateTime.UtcNow.AddDays(30))
    .CreateAndSignLicense(signingParameters);

Using Standard Assignments

If you do not want to use the fluent API for creation you can call CreateLicense on the ILicenseFactory interface and manipulate the license with standard assignments, then sign the license later on with the Sign method. Example:

using var signingParameters = new LicenseSigningParameters();

var licenseInformation = new TestLicense
{
    MaxUsers = 10000,
    IssuedTo = "Some Random User"
};

var license = LicenseKeyManager.Create(licenseInformation)
    .CreateLicense();

license.ExpirationDate = DateTime.UtcNow.AddDays(7);
license.LicenseType = LicenseType.Standard;
var signedLicense = license.Sign(signingParameters)

Once you have generated the license then you are free to transport it anywhere. So long as the public key is present the validator should be able to check its contents.

Validate The License in Your Application

The license data can be stored however you please, however once you start to validate the license you must reconstruct the SignedLicense object that the license was originally exported as. This class only consists of two fields, PublicKey and LienseData so this is not hard to do.

var licenseData = GetLicenseData();
var publicKey = GetLicenseKey();

var signedLicense = new SignedLicense(licenseData, publicKey);

once you have the SignedLicense object, you can use the license validation API to validate your license.


var signedLicense = GetSignedLicense();

if(!signedLicense.SignatureValid())
    throw new Exception("This license has been tampered with!");

var validationResults = LicenseKeyManager.Load<TestLicense>(signedLicense)
    .TypeNot(LicenseType.Trial)
    .ActivatesBefore(DateTime.UtcNow)
    .ExpiresAfter(DateTime.UtcNow, "License is expired")
    .MeetsCondition(license => license.LicenseData.IssuedTo == "Some Random User",
        "This license was issued to Some Random User, and you're not them!")
    .IfExpiresBefore(DateTime.UtcNow.AddDays(7), expirationDate 
        => Console.WriteLine("warning, license expires soon")
    .Validate();

if(validationResults.HasErrors)
    foreach(var error in validationResults.Errors)
        Console.WriteLine(error);

StandardLicensing License Keys will not throw any exceptions unless it fails to authenticate the license with its public key.

All errors will be put in the Errors property on the LicenseValidationResults<T> class and the user will be able to enumerate them manually. This class also exposes the physical license in the LicenseKey property, so license values can be read after validation.

🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/junian/Standard.Licensing/pull/16 **Author:** [@ConnerPhillis](https://github.com/ConnerPhillis) **Created:** 4/30/2020 **Status:** ❌ Closed **Base:** `master` ← **Head:** `master` --- ### 📝 Commits (2) - [`2aa9260`](https://github.com/junian/Standard.Licensing/commit/2aa926040c8edcf8c9ae1c150a0f801592d83a54) commit for LicenseKey code - [`b7ca62b`](https://github.com/junian/Standard.Licensing/commit/b7ca62bd8a65df4a1828e0a83cb77c910561bfd0) add readme ### 📊 Changes **24 files changed** (+1942 additions, -2 deletions) <details> <summary>View changed files</summary> ➕ `src/Standard.Licensing.LicenseKey.Tests/Extensions/TestExtensions.cs` (+6 -0) ➕ `src/Standard.Licensing.LicenseKey.Tests/KeyGeneration/StandardLicenseFactoryTests.cs` (+82 -0) ➕ `src/Standard.Licensing.LicenseKey.Tests/KeyValidation/StandardLicenseValidatorTests.cs` (+544 -0) ➕ `src/Standard.Licensing.LicenseKey.Tests/LicenseKeyTests.cs` (+36 -0) ➕ `src/Standard.Licensing.LicenseKey.Tests/LifecycleTests.cs` (+93 -0) ➕ `src/Standard.Licensing.LicenseKey.Tests/SignedLicenseTests.cs` (+34 -0) ➕ `src/Standard.Licensing.LicenseKey.Tests/Standard.Licensing.LicenseKey.csproj` (+22 -0) ➕ `src/Standard.Licensing.LicenseKey.Tests/TestLicenseKeyManager.cs` (+40 -0) ➕ `src/Standard.Licensing.LicenseKey.Tests/TestLicenses/SimpleTestLicense.cs` (+34 -0) ➕ `src/Standard.Licensing.LicenseKey/Internals/Extensions/JsonExtensions.cs` (+23 -0) ➕ `src/Standard.Licensing.LicenseKey/Jwt/JwtTokenManager.cs` (+90 -0) ➕ `src/Standard.Licensing.LicenseKey/KeyGeneration/ILicenseFactory.cs` (+49 -0) ➕ `src/Standard.Licensing.LicenseKey/KeyGeneration/StandardLicenseFactory.cs` (+49 -0) ➕ `src/Standard.Licensing.LicenseKey/KeyValidation/ILicenseValidator.cs` (+181 -0) ➕ `src/Standard.Licensing.LicenseKey/KeyValidation/LicenseValidationResults.cs` (+14 -0) ➕ `src/Standard.Licensing.LicenseKey/KeyValidation/StandardLicenseValidator.cs` (+234 -0) ➕ `src/Standard.Licensing.LicenseKey/LicenseKey.cs` (+60 -0) ➕ `src/Standard.Licensing.LicenseKey/LicenseKeyManager.cs` (+28 -0) ➕ `src/Standard.Licensing.LicenseKey/LicenseSigningParameters.cs` (+126 -0) ➕ `src/Standard.Licensing.LicenseKey/LicenseType.cs` (+10 -0) _...and 4 more files_ </details> ### 📄 Description This code is a massive effort I've been working on in spare time over the last few months for a school project. There is a readme attached in the PR detailing the new API that I have created for this repository. Here's the contents of the Readme as they exist now. ## Usage ### Creating License Signing Parameters StandardLicensing License Keys uses .Net's Cryptology APIs to create and sign the license keys it generates, more specifically, the `RsaSsaPssSha256` algorithm. Keys can be any length in bits that the RSA algorithm permits (512, 1024, 3096, etc...). The default is 2048 bits. #### Generating New License Parameters You can generate new keys for license signing by instantiating the `LicenseSigningParameters` with no arguments or one argument representing your desired key size. ```csharp // optionally you can pass the key size, defaults to 2048 bits using var licenseParameters = new LicenseSigningParameters(); ``` #### Saving License Parameters If you wish to store your public key in your application or simply wish to use the same private key for every new license you generate you will have to save your license parameters. This can be accomplished easily with the `Export` and `Import` methods which also support asynchronous code. ```csharp licenseParameters.Export("keys.txt"); // then, when you need the keys again using var signingParameters = LicenseSigningParameters.Import("keys.txt"); ``` ### Creating the License Generator StandardLicensing License Keys supports a base set of fields for licenses, but also has functionality to support further configuration through generics. This allows you to specify further strongly typed license details in the `KeyData` property. ```Csharp public class TestLicense { public int MaxUsers { get; set; } public string IssuedTo { get; set; } } ``` #### Using the Fluent API StandardLicensing License Keys also supports a fluent API to configure all of its license properties. ```CSharp using var signingParameters = new LicenseSigningParameters(); var licenseInformation = new TestLicense { MaxUsers = 10000, IssuedTo = "Some Random User" }; var signedLicense = LicenseKeyManager.Create(licenseInformation) .WithName("Test License") .WithType(LicenseType.Enterprise) .WithActivationDate(DateTime.UtcNow.AddDays(1)) .WithExpirationDate(DateTime.UtcNow.AddDays(30)) .CreateAndSignLicense(signingParameters); ``` #### Using Standard Assignments If you do not want to use the fluent API for creation you can call `CreateLicense` on the `ILicenseFactory` interface and manipulate the license with standard assignments, then sign the license later on with the `Sign` method. Example: ```csharp using var signingParameters = new LicenseSigningParameters(); var licenseInformation = new TestLicense { MaxUsers = 10000, IssuedTo = "Some Random User" }; var license = LicenseKeyManager.Create(licenseInformation) .CreateLicense(); license.ExpirationDate = DateTime.UtcNow.AddDays(7); license.LicenseType = LicenseType.Standard; var signedLicense = license.Sign(signingParameters) ``` Once you have generated the license then you are free to transport it anywhere. So long as the public key is present the validator should be able to check its contents. ### Validate The License in Your Application The license data can be stored however you please, however once you start to validate the license you must reconstruct the `SignedLicense` object that the license was originally exported as. This class only consists of two fields, `PublicKey` and `LienseData` so this is not hard to do. ```csharp var licenseData = GetLicenseData(); var publicKey = GetLicenseKey(); var signedLicense = new SignedLicense(licenseData, publicKey); ``` once you have the `SignedLicense` object, you can use the license validation API to validate your license. ```Csharp var signedLicense = GetSignedLicense(); if(!signedLicense.SignatureValid()) throw new Exception("This license has been tampered with!"); var validationResults = LicenseKeyManager.Load<TestLicense>(signedLicense) .TypeNot(LicenseType.Trial) .ActivatesBefore(DateTime.UtcNow) .ExpiresAfter(DateTime.UtcNow, "License is expired") .MeetsCondition(license => license.LicenseData.IssuedTo == "Some Random User", "This license was issued to Some Random User, and you're not them!") .IfExpiresBefore(DateTime.UtcNow.AddDays(7), expirationDate => Console.WriteLine("warning, license expires soon") .Validate(); if(validationResults.HasErrors) foreach(var error in validationResults.Errors) Console.WriteLine(error); ``` StandardLicensing License Keys will not throw any exceptions unless it fails to authenticate the license with its public key. All errors will be put in the `Errors` property on the `LicenseValidationResults<T>` class and the user will be able to enumerate them manually. This class also exposes the physical license in the `LicenseKey` property, so license values can be read after validation. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
kerem 2026-02-26 02:30:18 +03:00
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
master
v1.2.2
v1.2.1
v1.1.9
v1.1.7
v1.1.6
v1.1.5
Labels
Clear labels   
pull-request

Mirrored from GitHub Pull Request

No labels
pull-request
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
starred/Standard.Licensing#43
No description provided.