Sidub.Licensing.Client 1.5.87

Sidub.Licensing.Client

.NET client SDK for Monaiq licensing by Sidub — license enforcement, feature gating, rate limiting, and metered consumption reporting for applications that hold a Monaiq license.

Install

dotnet add package Sidub.Licensing.Client

Targets netstandard2.1 — usable from .NET Core 3.0+, .NET 5+ and modern .NET.

Setup

Register the SDK and bind your credential. The encoded credential (SIDUB_LIC_…) comes from the Monaiq portal or your license-delivery email and bundles everything the SDK needs.

using Sidub.Licensing;
using Sidub.Licensing.Client;

builder.Services.Configure<LicensingServiceOptions>(options =>
{
    options.LicenseServiceUri = "https://api.monaiq.com/licensing";
    options.ConsumptionServiceUri = "https://api.monaiq.com/consumption";
    options.EncodedCredential = builder.Configuration["Licensing:EncodedCredential"];
});

builder.Services.AddSidubLicensing();

Check a license

ILicensingService is the enforcement surface: fetch a signed authorization, gate features against it, and record metered operations. The LicensingContextAccessor resolves the configured credential.

using Sidub.Licensing;
using Sidub.Licensing.Context;
using Sidub.Licensing.Exceptions;
using Sidub.Licensing.Features;
using Sidub.Licensing.Services;

public sealed class ReportService(ILicensingService licensing, LicensingContextAccessor contextAccessor)
{
    private static readonly LicensingServiceReference ServiceReference = new();

    public async Task RunAsync()
    {
        var context = await contextAccessor.GetContextAsync()
            ?? throw new InvalidOperationException("No license is configured.");

        // A cryptographically signed, cached authorization for the configured license.
        var authorization = await licensing.GetAuthorization(ServiceReference, context);

        // Gate a rate-limited feature; the sliding window is enforced locally.
        var feature = await licensing.GetLicenseFeature<RateLimitLicenseFeature>(
            ServiceReference, context, "reports.generate");

        try
        {
            await licensing.PerformOperation<RateLimitLicenseFeature, RateLimitLicenseFeatureState>(
                ServiceReference, context, new RateLimitLicenseFeatureOperation(feature!, 1));
        }
        catch (RateLimitException)
        {
            // The throw IS the enforcement signal — surface an upgrade path to the user.
        }
    }
}

AssertLicense evaluates declarative assertions (feature existence, service access, rate limits) against an authorization; rate-limit violations throw RateLimitException rather than returning false.

Resilience built in

• Authorization fetches retry transient failures with bounded backoff and a per-attempt timeout; exhaustion surfaces as a typed LicenseAuthorizationUnavailableException.
• The last signature-verified authorization bridges brief API outages inside a bounded grace window — denials and revocations are never bridged.
• Metered consumption is buffered, aggregated, and delivered with exactly-once submission identity; buffered usage flushes on shutdown.

Learn more

• Documentation: https://docs.monaiq.com
• Getting started: https://docs.monaiq.com/getting-started/quickstart.html
• .NET guide: https://docs.monaiq.com/guides/dotnet.html
• Issues: https://github.com/Sidub-Inc/Sidub.Licensing/issues

© Sidub Inc. Proprietary license — see the LICENSE file.