Licenze

Questa pagina è il riferimento a runtime su come una licenza influisce sul comportamento di Doconut: cosa consente ogni stato di licenza, come vengono concesse le funzionalità e come ispezionare tutto dal codice. (Per caricare una licenza, vedere Guida introduttiva → Configurazione licenza.)

Stati della licenza e cosa fanno

Due conseguenze da interiorizzare:

• Una licenza mancante non è una licenza temporanea. Senza file di licenza, le pagine vengono visualizzate con filigrana e nessuna funzionalità (ricerca, annotazione, plugin) è attiva. L'esperienza completa, senza filigrana, richiede una Licenza temporanea (ottieni una).
• Solo una licenza rifiutata blocca l'apertura. La scadenza del calendario/abbonamento degrada la visualizzazione a filigrana; ma distribuire una build più recente della finestra di versione della licenza è rifiutato e fallisce rapidamente con una LicenseException, così lo intercetti al deploy — non inviando silenziosamente output con filigrana. Quell'eccezione (da OpenDocumentAsync) contiene il motivo da License.RejectionMessage.

Funzionalità

Doconut controlla le funzionalità opzionali tramite funzionalità. Oggi sono i plugin opzionali Converter e DICOM più le funzionalità integrate Search e Annotation, ciascuna concessa dalla tua licenza. Il visualizzatore di base non è una funzionalità — è il prerequisito, esposto come IsViewerLicensed:

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

L'unico controllo che utilizza l'intera pipeline è IsCapabilityGranted:

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

La sua logica, parola per parola dall'implementazione: una licenza Temporanea attiva (non scaduta) concede tutte le funzionalità — incluse quelle che non hanno ancora un flag di acquisto dedicato; una licenza acquistata reale concede esattamente i suoi flag Has* ed è default-deny per qualsiasi cosa non mappata. (Un file legacy di tipo TRIAL non è un diritto — viene trattato come non licenziato: con filigrana, nessuna concessione.)

Licenze temporanee

Le licenze temporanee (Developer/NFR) sono contrassegnate da un tag ExpiryNote e hanno una data di scadenza rigida:

La semantica della scadenza varia per livello: una licenza temporanea scade alla sola data di LicenseExpiry (la sua finestra di abbonamento è ignorata; una licenza temporanea priva della data è trattata come scaduta, in modalità fail-safe). Tutte le altre licenze scadono alla data della loro finestra di abbonamento/aggiornamento.

Riferimento IDoconutLicenseService

Inietta IDoconutLicenseService (namespace Doconut.Core.Interfaces; registrato come singleton — la licenza è analizzata una volta all'avvio):

DoconutLicenseInfo espone l'istantanea visualizzabile per i pannelli admin: Owner, Email, LicenseType, Domain, IsLicenseFileFound, IsVersionValid, IsTrial, IsExpired, i flag Has*, i campi della licenza temporanea e RejectionMessage.

// Feature-flag your UI from the same source of truth the SDK uses
app.MapGet("/api/features", (IDoconutLicenseService lic) => Results.Ok(new
{
    viewer     = lic.IsViewerLicensed || lic.IsTemporary,
    search     = lic.IsCapabilityGranted(LicenseCapability.Search),
    annotation = lic.IsCapabilityGranted(LicenseCapability.Annotation),
    conversion = lic.HasConverter,
    dicom      = lic.HasDicom,
}));

Controllo di salute

AddDoconut() registra un controllo di salute "doconut" che segnala lo stato della licenza/scadenza tramite il meccanismo standard di ASP.NET Core:

app.MapHealthChecks("/health");

Collegalo al tuo monitoraggio e un abbonamento in scadenza diventa un avviso invece di un ticket di supporto.

Aggiornamenti di versione

Una licenza copre una finestra di versione. Aggiornare il pacchetto NuGet a una build più recente della finestra rende la licenza non valida per questa build: IsVersionValid diventa false e l'apertura è bloccata con una LicenseException (il motivo è in License.RejectionMessage) — fallimento rapido deliberato, così una build obsoleta o non licenziata viene intercettata al deploy invece di aggiungere silenziosamente una filigrana all'output di produzione. Rinnova l'abbonamento, sostituisci il file .lic e riavvia l'applicazione affinché AddDoconut() carichi la nuova licenza.