Licensiering

Denna sida är referensen vid körning för hur en licens formar Doconut's beteende: vad varje licenstillstånd tillåter, hur funktioner beviljas, och hur man inspekterar allt detta från kod. (För laddning av en licens, se Licensinställning.)

Licenstillstånd och vad de gör

Två konsekvenser värda att internalisera:

• En saknad licens är inte en tillfällig licens. Utan licensfil visas sidor med vattenstämpel och ingen funktion (sökning, annotering, plugins) är aktiv. Den fullständiga, vattenstämpelfria upplevelsen kräver en faktisk Tillfällig licens (skaffa en).
• Endast en avvisad licens blockerar öppning. Kalender-/prenumerationsutgång degraderas till renderad med vattenstämpel; men att distribuera en byggnad nyare än licensens versionsfönster avvisas och misslyckas snabbt med en LicenseException, så du fångar den vid distribution — inte genom att tyst skicka vattenstämplad output. Undantaget (från OpenDocumentAsync) bär med sig orsaken från License.RejectionMessage.

Funktioner

Doconut styr valfri funktionalitet med funktion. Idag är det de valfria Converter- och DICOM-pluginsen plus de inbyggda Search- och Annotation-funktionerna, var och en beviljad av din licens. Basvisaren är inte en funktion — den är förutsättningen, exponerad som IsViewerLicensed:

bool viewerLicensed = lic.IsViewerLicensed; // non-TRIAL license present AND covering this build's version

Den enda grind som hela pipeline använder är IsCapabilityGranted:

bool searchGranted = lic.IsCapabilityGranted(LicenseCapability.Search);

Dess logik, ordagrant från implementationen: en aktiv (ej utgången) Tillfällig licens beviljar alla funktioner — inklusive funktioner som ännu inte har en dedikerad köpflagga; en riktig köpt licens beviljar exakt dess Has*-flaggor och är standard-nektande för allt som inte är mappat. (En äldre TRIAL-typ fil är inte en rättighet — den behandlas som olicensierad: vattenstämpel, inget beviljat.)

Tillfälliga licenser

Tillfälliga (Utvecklare/NFR) licenser markeras med en ExpiryNote-tagg och har ett fast utgångsdatum:

Utgångssemantiken skiljer sig per nivå: en tillfällig licens går ut på dess LicenseExpiry endast datum (dess prenumerationsfönster ignoreras; en tillfällig licens utan datum behandlas som utgången, felsäker). Alla andra licenser går ut på deras prenumerations-/uppdateringsfönster‑datum.

IDoconutLicenseService‑referens

Hämta IDoconutLicenseService (namnrymd Doconut.Core.Interfaces) från DoconutHost.Services. Det är en singleton — licensen parsas en gång, i DoconutHost.Initialize:

DoconutLicenseInfo exponerar den display‑vänliga ögonblicksbilden för admin‑paneler: Owner, Email, LicenseType, Domain, IsLicenseFileFound, IsVersionValid, IsTrial, IsExpired, Has*‑flaggorna, de tillfälliga licensfälten och RejectionMessage.

// GET /Features - feature-flag your UI from the same source of truth the SDK uses
public ActionResult Index()
{
    var lic = Doconut.DoconutHost.Services.GetRequiredService<IDoconutLicenseService>();

    return Json(new
    {
        viewer     = lic.IsViewerLicensed || lic.IsTemporary,
        search     = lic.IsCapabilityGranted(LicenseCapability.Search),
        annotation = lic.IsCapabilityGranted(LicenseCapability.Annotation),
        conversion = lic.HasConverter,
        dicom      = lic.HasDicom,
    }, JsonRequestBehavior.AllowGet);
}

Hälsokontroll

Doconut registrerar en "doconut"-hälsokontroll som rapporterar licenstillståndet. Classic ASP.NET har ingen egen hälsoslutpunkt, så exponera den från en controller:

// GET /Health - Doconut registers a "doconut" health check that reports the license state:
// Healthy (valid), Degraded (trial or no license file), Unhealthy (expired).
public async Task<ActionResult> Index()
{
    var health = Doconut.DoconutHost.Services.GetRequiredService<HealthCheckService>();
    HealthReport report = await health.CheckHealthAsync();

    Response.StatusCode = report.Status == HealthStatus.Unhealthy ? 503 : 200;
    return Content(report.Status.ToString(), "text/plain");
}

Koppla in den i din övervakning så blir en utgående prenumeration ett larm istället för en supportärende. Se DoconutHost för statusvärdena.

Versionsuppgraderingar

En licens täcker ett versionsfönster. Att uppdatera NuGet‑paketet till en byggnad nyare än det fönstret gör licensen ogiltig för denna byggnad: IsVersionValid blir false och öppning blockeras med en LicenseException (orsaken finns i License.RejectionMessage) — avsiktligt misslyckas snabbt, så en föråldrad eller olicensierad byggnad fångas vid distribution snarare än att tyst vattenstämpla produktionsoutput. Förnya prenumerationen, ersätt .lic i wwwroot, och återvinn applikationspoolen så att DoconutHost.Initialize laddar den nya licensen.