Licenze

Funzionalità, livelli di licenza e il servizio di licenza

Questa pagina è il riferimento a runtime su come una licenza influenza il 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

StatoApre documenti?FiligranaFunzionalità
Licenza completa (a pagamento) (questa build è stata rilasciata prima della sua data di sottoscrizione)SìNessunaQuelle acquistate (flag Has*)
Licenza temporanea (Sviluppatore/NFR — la licenza di valutazione, prima della sua data di scadenza)SìNessuna sul visualizzatore di base; l'output del plugin è filigranatoTutte — concessione totale (il funnel di valutazione)
Licenza temporanea scaduta (oltre la sua data LicenseExpiry)SìFiligrana di valutazioneNessuna concessa
Nessun file di licenzaSìFiligrana di valutazioneNessuna concessa
Trovata ma rifiutata (firma non valida, manomessa, nella lista nera, o una build rilasciata dopo la data di sottoscrizione della licenza)No — LicenseException ad ogni apertura——

Una licenza a pagamento la cui data di sottoscrizione è passata continua a funzionare — pulita, con le sue funzionalità — su ogni build rilasciata prima di quella data. Solo una build rilasciata dopo di essa viene rifiutata.

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 vera Licenza temporanea (ottieni una).
  • Solo una licenza rifiutata blocca l'apertura. Una Licenza Temporanea scaduta mantiene l'app in esecuzione con la filigrana di valutazione, e una licenza a pagamento oltre la sua data di sottoscrizione continua a renderizzare pulito sulle build che copre; ma distribuire una build rilasciata dopo la data di sottoscrizione della licenza viene rifiutata e fallisce rapidamente con un LicenseException, così la si intercetta al deploy — non inviando silenziosamente output filigranato. Quell'eccezione (da OpenDocumentAsync) trasporta il motivo da License.RejectionMessage.

Funzionalità

Doconut controlla le funzionalità opzionali tramite funzionalità. Copre le funzionalità integrate Search e Annotation e i plugin opzionali Converter, Dicom e Signer, ognuno concesso dalla tua licenza. Il visualizzatore di base non è una funzionalità — è il prerequisito, esposto come IsViewerLicensed:

csharp
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // licenza non-TRIAL presente AND che copre la versione di questa build

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

csharp
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
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 reale acquistata concede esattamente i suoi flag Has* e ha un comportamento default-deny per qualsiasi cosa non mappata. (Un file legacy di tipo TRIAL non è un diritto — viene trattato come non licenziato: filigranato, nulla concesso.)

Licenze temporanee

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

MembroSignificato
IsTemporaryÈ presente un tag ExpiryNote (il rilevamento avviene per presenza del tag — non corrisponde mai al testo della nota, è dinamico)
ExpiryNoteTesto informativo incorporato nella licenza
LicenseExpiryLa data di scadenza rigida (DateTime?)

La semantica della scadenza varia per livello: una licenza temporanea scade alla sua data LicenseExpiry (la sua finestra di sottoscrizione è ignorata; una licenza temporanea priva della data è trattata come scaduta, in modalità fail-safe). Tutte le altre licenze scadono alla data della finestra di sottoscrizione/aggiornamento; per una licenza a pagamento, IsExpired segnala solo che questa data è passata — le build rilasciate prima rimangono pulite e mantengono le loro funzionalità.

Riferimento IDoconutLicenseService

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

MembroSignificato
LicenseIstantanea completa DoconutLicenseInfo (sotto)
IsTrialUn file legacy di tipo TRIAL (trattato come non licenziato — non un diritto)
IsTemporary / ExpiryNote / LicenseExpiryMarcatori di licenza temporanea
IsExpiredScaduta secondo le regole di livello sopra
IsVersionValidQuesta build rientra nella finestra di supporto della licenza
IsViewerLicensedFile non-TRIAL trovato e versione coperta — prerequisito di base
IsCapabilityGranted(cap)L'unico gate di funzionalità
HasSearch HasAnnotation HasEditor HasConverter HasDicom HasDocumentTools HasSigner HasRedactor HasComparer HasForms HasProtector HasCompressorUn flag per funzionalità: acquistato da una licenza che copre questa build, o concesso da una licenza Temporanea attiva. IsCapabilityGranted risponde alla stessa domanda per funzionalità
IsValidForDomain(host)Copertura host; le licenze V4 usano il wildcard *.*
LicenseRejectionReasonNon vuoto ⇒ l'apertura è bloccata con questo messaggio

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

csharp
// Imposta il Feature-flag della tua UI dalla stessa fonte di verità usata dall'SDK
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 riporta lo stato della licenza/scadenza tramite il meccanismo standard di ASP.NET Core:

csharp
app.MapHealthChecks("/health");

Integralo nel tuo monitoraggio e una sottoscrizione in scadenza diventa un avviso invece di un ticket di supporto. Il controllo riporta Unhealthy quando la licenza è rifiutata o IsExpired è vero; per una licenza a pagamento, ciò significa che la data di sottoscrizione è passata e un pacchetto rilasciato dopo di essa sarà rifiutato — la build corrente continua a renderizzare pulita.

Aggiornamenti di versione

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

Questa pagina è stata utile?