LicenseManagement.Client 1.2.0

LicenseManagement.Client

Server-side SDK for license-management.com - A license management platform for software vendors.

Features

• License Management - Create, retrieve, and update licenses
• Receipt Management - Manage purchase records and subscriptions
• Computer Tracking - Register and track end-user devices
• Product Management - Create and manage software products
• Webhook Support - Full webhook lifecycle management with signature validation
• Multi-Framework - Supports .NET Standard 2.0, .NET 6.0, and .NET 8.0

Installation

dotnet add package LicenseManagement.Client

Quick Start

Basic Setup

using LicenseManagement.Client;
using Microsoft.Extensions.DependencyInjection;

// Register the client in your DI container
services.AddLicenseManagementClient(options =>
{
    options.ApiKey = "MST_01ARZ3..."; // Your master API key
    options.BaseUrl = "https://license-management.com/api";
});

Using the Client

public class LicenseService
{
    private readonly ILicenseManagementClient _client;

    public LicenseService(ILicenseManagementClient client)
    {
        _client = client;
    }

    public async Task<License?> GetLicenseAsync(string productId, string computerId)
    {
        return await _client.GetLicenseAsync(productId, computerId);
    }

    public async Task<Receipt> CreateReceiptAsync(string productId, string buyerEmail, int qty)
    {
        return await _client.CreateReceiptAsync(new CreateReceiptRequest
        {
            Product = productId,
            BuyerEmail = buyerEmail,
            Qty = qty,
            Expires = DateTime.UtcNow.AddYears(1)
        });
    }
}

API Reference

Licenses

Receipts

Products

Computers

Signing Keys

Webhooks

Webhook Signature Validation

For ASP.NET Core applications (.NET 6.0+), use the built-in filter:

// Register webhook validation
services.AddLicenseManagementWebhooks(options =>
{
    options.Secret = "whsec_...";
    options.TimestampTolerance = TimeSpan.FromMinutes(5);
});

// Apply to controller
[HttpPost("webhook")]
[EnsureIsFromLicenseManagement]
public async Task<IActionResult> HandleWebhook([FromBody] WebhookPayload payload)
{
    // Signature is automatically validated
    return Ok();
}

Error Handling

try
{
    var license = await _client.GetLicenseAsync(productId, computerId);
}
catch (LicenseManagementException ex)
{
    Console.WriteLine($"Error: {ex.StatusCode} - {ex.Message}");
    // Handle specific status codes: 400, 401, 403, 404, 409, 422
}

Configuration Options

Requirements

• .NET Standard 2.0+ / .NET 6.0+ / .NET 8.0+
• Master API key from license-management.com

License

MIT - See LICENSE for details.

Related Packages

• LicenseManagement.EndUser - End-user SDK for license validation
• LicenseManagement.EndUser.Wpf - WPF components for license UI