ExisOne.Client 0.8.2

ExisOne.Client

.NET client SDK for the ExisOne Software Activation System. Supports online licensing, offline (air-gapped) licensing, and smart validation that auto-detects the license type.

Installation

dotnet add package ExisOne.Client

Quick Start

using ExisOne.Client;

var client = new ExisOneClient(new ExisOneClientOptions
{
    BaseUrl = "https://your-exisone-api.com",
    AccessToken = "your-api-token"
});

// Generate a hardware-locked ID for this machine
var hardwareId = client.GenerateHardwareId();

// Activate a license
var activation = await client.ActivateAsync(activationKey, email, hardwareId, "YourProduct");

if (activation.Success)
    Console.WriteLine("License activated!");
else
    Console.WriteLine($"Failed: {activation.ErrorMessage}");

// Validate a license
var (isValid, status, expiration, features, _, _) =
    await client.ValidateAsync(hardwareId, "YourProduct", activationKey);

if (isValid)
    Console.WriteLine($"Licensed until {expiration}, features: {string.Join(",", features)}");

// Deactivate
await client.DeactivateAsync(activationKey, hardwareId, "YourProduct");

Offline Licensing

For air-gapped environments, configure the client with your public key (found in the ExisOne dashboard under Crypto Keys):

var client = new ExisOneClient(new ExisOneClientOptions
{
    BaseUrl = "https://your-exisone-api.com",
    AccessToken = "your-api-token",
    OfflinePublicKey = @"-----BEGIN PUBLIC KEY-----
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8A...
-----END PUBLIC KEY-----"
});

var hardwareId = client.GenerateHardwareId();

// Smart validation — auto-detects online vs offline keys
var result = await client.ValidateSmartAsync(licenseKey, hardwareId, "YourProduct");

if (result.IsValid)
{
    Console.WriteLine($"Licensed until: {result.ExpirationDate}");
    Console.WriteLine($"Offline: {result.WasOffline}");
}

// Or validate offline codes directly (no network)
var offline = client.ValidateOffline(offlineCode, hardwareId);

Offline Workflow

1. Your app calls client.GenerateHardwareId() and displays it to the user
2. The user provides the hardware ID to your support team
3. An admin generates an offline code in the ExisOne dashboard
4. The user enters the code in your app
5. Your app validates locally with ValidateOffline() or ValidateSmartAsync()

Links

• Documentation
• Dashboard