UnifiedLicensing 4.0.0

UnifiedLicensing .NET SDK v4.0

Modular, Secure, Feature-Complete License Management

🎯 Features

Core Features

• ✅ AES-256-GCM Encryption - Secure local license storage
• ✅ RSA Signature Verification - Tamper-proof licenses
• ✅ Hardware Binding - None/Loose/Strict modes
• ✅ Clock Tamper Detection - Prevent time manipulation
• ✅ Hybrid Validation - Offline-first with background sync

Advanced Protection

• ✅ IntegrityGuard - Runtime protection with multiple validation timers
• ✅ Anti-Debugging - Detect debuggers and analysis tools
• ✅ Anti-Tampering - DLL integrity checks and memory patching detection
• ✅ Blacklist Detection - Identify debugging/hacking tools

Validation Strategies

• ✅ Online-Only - Always validate with server
• ✅ Offline-Only - Use cached licenses only
• ✅ Hybrid - Offline-first with background validation
• ✅ Adaptive - Automatically choose best strategy

Additional Features

• ✅ Trial Activation - Start trials programmatically
• ✅ Analytics Tracking - Feature usage and conversion tracking
• ✅ Grace Periods - Continue working after validation failures
• ✅ License File Installation - Import licenses from files
• ✅ Event System - React to license events

📦 Installation

dotnet add package UnifiedLicensing

🚀 Quick Start

using UnifiedLicensing.v4;
using UnifiedLicensing.v4.Core;

// Configure SDK
var config = new UnifiedLicenseConfig
{
    VendorApiKey = "your-api-key",
    ProductKey = "your-product-key",
    Strategy = ValidationStrategy.Hybrid,
    Encryption = true,
    SignatureVerification = true,
    HardwareBinding = HardwareBindingMode.Loose,
    EnableIntegrityGuard = true,
    EnableAnalytics = true
};

// Initialize manager
var licenseManager = new UnifiedLicenseManager(config);

// Validate license
var result = await licenseManager.ValidateLicenseAsync("LICENSE-KEY-HERE");

if (result.Valid)
{
    Console.WriteLine($"✅ License valid! Tier: {result.LicenseInfo.Tier}");
}
else
{
    Console.WriteLine($"❌ License invalid: {result.Error}");
}

🏗️ Architecture

v4/
├── Core/
│   ├── UnifiedLicenseConfig.cs    # Configuration
│   └── Models.cs                   # Data models
├── Security/
│   ├── SecureStorage.cs            # AES-256-GCM encryption
│   ├── SignatureVerifier.cs        # RSA signature verification
│   ├── HardwareFingerprint.cs      # Advanced hardware detection
│   └── ClockTamperDetector.cs      # Clock tampering detection
├── Protection/
│   └── IntegrityGuard.cs           # Runtime protection
├── Services/
│   ├── LicenseApiClient.cs         # API communication
│   ├── OfflineValidator.cs         # Offline validation
│   ├── ValidationStrategies.cs     # Multiple strategies
│   └── AnalyticsTracker.cs         # Analytics tracking
└── UnifiedLicenseManager.cs        # Main entry point

📖 Usage Examples

Start a Trial

var result = await licenseManager.StartTrialAsync(
    "customer@example.com",
    metadata: new Dictionary<string, object>
    {
        ["source"] = "website",
        ["campaign"] = "summer2025"
    }
);

if (result.Success)
{
    Console.WriteLine($"Trial started! License: {result.LicenseKey}");
}

Track Feature Usage

await licenseManager.TrackFeatureUsageAsync(
    "LICENSE-KEY",
    "advanced_filter",
    metadata: new Dictionary<string, object>
    {
        ["filter_type"] = "blur",
        ["intensity"] = 75
    }
);

Enable Protection

var config = new UnifiedLicenseConfig
{
    // ... other config
    EnableIntegrityGuard = true,
    EnableAntiDebug = true,
    EnableAntiTamper = true
};

var manager = new UnifiedLicenseManager(config);

// Protection starts automatically
// Or manually control:
manager.StartProtection();
manager.StopProtection();

Handle Events

licenseManager.OnLicenseExpired += (sender, result) =>
{
    Console.WriteLine("License expired! Show renewal dialog.");
};

licenseManager.OnQuotaExceeded += (sender, result) =>
{
    Console.WriteLine("API quota exceeded! Show upgrade prompt.");
};

licenseManager.OnTamperDetected += (sender, args) =>
{
    Console.WriteLine("Tampering detected! Taking action...");
    Environment.Exit(1);
};

Validation Strategies

// Online-only (always check server)
var config = new UnifiedLicenseConfig
{
    Strategy = ValidationStrategy.OnlineOnly
};

// Offline-only (use cache only)
var config = new UnifiedLicenseConfig
{
    Strategy = ValidationStrategy.OfflineOnly
};

// Hybrid (offline-first, background sync)
var config = new UnifiedLicenseConfig
{
    Strategy = ValidationStrategy.Hybrid,
    BackgroundValidation = true
};

// Adaptive (automatically choose best)
var config = new UnifiedLicenseConfig
{
    Strategy = ValidationStrategy.Adaptive
};

🔒 Security Features

Hardware Binding Modes

// None - No hardware binding
HardwareBinding = HardwareBindingMode.None

// Loose - 70% similarity required (allows minor hardware changes)
HardwareBinding = HardwareBindingMode.Loose

// Strict - Exact match required
HardwareBinding = HardwareBindingMode.Strict

IntegrityGuard Protection

The IntegrityGuard runs multiple validation timers:

• Timer A (5-8s): Debugger detection
• Timer B (10-15s): Blacklisted process detection
• Timer C (15-25s): Hardware fingerprint validation
• Timer D (20-30s): DLL integrity checks
• Timer E (30-45s): Stored hash validation

Random intervals make timing attacks harder.

🎯 Comparison: v2 vs v4

📝 License

MIT License - See LICENSE file for details

🤝 Support

• Documentation: https://docs.unifiedlicensing.com
• Issues: https://github.com/unifiedlicensing/sdk/issues
• Email: support@unifiedlicensing.com

🚀 Roadmap

• Mobile platform support (iOS/Android)
• Floating license support
• License server (self-hosted)
• Advanced obfuscation
• Cloud license sync