AstraGuard.SDK 2.2.3

AstraGuard.SDK — .NET License Management

The official .NET SDK for integrating AstraGuard license management into your applications.

Quick Start

Installation

dotnet add package AstraGuard.SDK

Basic Usage

using AstraGuard.SDK;

var guard = new AstraGuardClient(
    apiUrl: "https://api.astraguard.io",
    productId: "YOUR-PRODUCT-ID"
);

// Verify license or exit automatically
await guard.VerifyOrExit(userLicenseKey);

// Your application code runs here - license is valid!
RunYourApplication();

Features

Usage Examples

1. Simple Protection

var guard = new AstraGuardClient("https://api.astraguard.io", "PRODUCT-ID");
await guard.VerifyOrExit(licenseKey);
Console.WriteLine("Licensed application running!");

2. Advanced Integration

var guard = new AstraGuardClient("https://api.astraguard.io", "PRODUCT-ID");

// Enable protections
guard.EnableProtections();

// Event handlers
guard.OnLicenseInvalid += (s, e) => HandleInvalidLicense();
guard.OnCloudConfigUpdated += (s, config) => UpdateFeatures(config);

// Verify license
var result = await guard.VerifyLicense(licenseKey);
if (!result.Valid)
{
    Console.WriteLine($"Invalid: {result.Error}");
    return;
}

// Start continuous validation
guard.StartHeartbeat(TimeSpan.FromMinutes(5));

RunApp();

guard.StopHeartbeat();
guard.Dispose();

3. Cloud Configuration

⚠️ Security Notice: Cloud Variables are stored as plain strings in process memory after retrieval. They are suitable for configuration values (MOTD, URLs, feature labels) but not for security-critical gates. A memory scanner can read and modify these values at runtime. Do not use GetCloudVariable() as the sole check for unlocking paid features or sensitive access.

// Check maintenance mode
if (guard.IsMaintenanceMode())
{
    Console.WriteLine("App is in maintenance");
    return;
}

// Get remote variables (use for config, not security gates)
string? motd = guard.GetCloudVariable("motd");
bool premium = guard.GetCloudVariable("premium_mode") == "true"; // ← Not tamper-proof alone

// Access all variables
foreach (var kvp in guard.CloudConfig)
{
    Console.WriteLine($"{kvp.Key} = {kvp.Value}");
}

4. Custom HWID

// Use auto-generated HWID
await guard.VerifyLicense(licenseKey);

// Or provide custom HWID
await guard.VerifyLicense(licenseKey, "MY-CUSTOM-DEVICE-ID");

// Get the auto-generated HWID
string hwid = AstraGuardClient.GetMachineId();

API Reference

AstraGuardClient

Constructor

AstraGuardClient(string apiUrl, string productId)

Methods

Properties

Events

Error Handling

var result = await guard.VerifyLicense(licenseKey);

if (!result.Valid)
{
    switch (result.Error)
    {
        case "Key not found":
            Console.WriteLine("Invalid license key");
            break;
        case "Key is revoked":
            Console.WriteLine("License has been revoked");
            break;
        case "HWID mismatch":
            Console.WriteLine("License bound to another device");
            break;
        default:
            Console.WriteLine($"Error: {result.Error}");
            break;
    }
}

Requirements

• .NET 8.0 or later
• Newtonsoft.Json >= 13.0.3

Support

• Discord: Join Server
• Docs: docs.astraguard.io

License

MIT License

Made with ❤️ by AstraGuard