TaltosWorks.Licensing.Core 1.1.1

TaltosWorks.Licensing

A .NET Standard 2.0 library for license generation, validation, and management. This library provides a secure licensing system that utilizes RSA encryption for signature verification.

Features

• Create and manage RSA key pairs for license signing
• Generate signed license files
• Validate licenses with expiration support
• Embed public keys in assemblies
• Support for trial and perpetual license types

Getting Started

Installation

'Install-Package TaltosWorks.Licensing.Core'

Key Concepts

• LicenseManager: Used by publishers to generate keys and create licenses
• LicenseHelper: Used by consumer applications to validate licenses
• LicenseBase: Base class for all license models

Usage Examples

Creating a Custom License Model

Create a class that inherits from LicenseBase to define your custom license properties:

public class MyAppLicense : LicenseBase 
{ 
    public string[] Features { get; set; } 
    
    public int MaxUsers { get; set; }
    
    // You can override the validator, that gets the context from the helper
    protected override void Validate(IDictionary<string, string> validationErrors, object? validationContext)
    {
        // cast the context to your type and validate
    }
}

Creating and Saving Key Pairs

// Initialize license manager 
var licenseManager = new LicenseManager();
// Generate and save key pair 
await licenseManager.SaveKeyPair("MyAppLicense.rsa.keypair");
// Save public key separately (to be distributed with application) 
await licenseManager.SavePublicKey("MyAppLicense.rsa.public");

Creating License Files

// First load your key pair var 
licenseManager = new LicenseManager(); 
await licenseManager.LoadKeyPair("MyAppLicense.rsa.keypair");
// Create a new license 
var license = new MyAppLicense { LicenseType = LicenseType.Trial, LicensedTo = "Customer Name", Expires = DateTime.Now.AddDays(30), Features = new[] { "Basic", "Advanced", "Premium" }, MaxUsers = 5 };
// Save the license to a file 
await licenseManager.SaveLicense(license, "customer-license.lic");

Embedding Public Key in Your Application

1. Add your public key file to your project as an embedded resource
2. Set the Build Action to "Embedded Resource"
3. Make sure the namespace matches your assembly structure

Loading and Validating a License

// Create license helper with public key from file 
var licenseHelper = new LicenseHelper<MyAppLicense>("MyAppLicense.rsa.public");
// Or load from embedded resource
// var licenseHelper = new LicenseHelper<MyAppLicense>(Assembly.GetExecutingAssembly());

// Load and validate the license
var license = await licenseHelper.LoadLicense("customer-license.lic");

By default only the expirationng date is validated. You can override the Validate method in your custom license class to add additional validation logic. Of course, you can use the returned license object to check the properties you set in your custom license class.