Licenze
Funzionalità, livelli di licenza e il servizio di licenza
Questa pagina è il riferimento di runtime su come una licenza influenza il comportamento di Doconut: cosa consente ogni stato della licenza, come vengono concesse le funzionalità e come ispezionare tutto dal codice. (Per caricare una licenza, vedere Introduzione → Configurazione licenza.)
Stati della licenza e cosa fanno
| Stato | Apre documenti? | Filigrana | Funzionalità |
|---|---|---|---|
| Licenza completa (a pagamento) (questa compilazione è stata rilasciata prima della sua data di sottoscrizione) | Sì | Nessuna | Le segnalazioni acquistate (Has* flags) |
| Licenza temporanea (Sviluppatore/NFR — la licenza di valutazione, prima della sua data di scadenza) | Sì | Nessuna nel visualizzatore di base; l'output del plugin è contrassegnato da filigrana | Tutte — concessione totale (il funnel di valutazione) |
Licenza temporanea scaduta (passata la data LicenseExpiry) | Sì | Filigrana di valutazione | Nessuna concessa |
| Nessun file di licenza | Sì | Filigrana di valutazione | Nessuna concessa |
| Trovata ma rifiutata (firma non valida, manomessa, in lista nera, o una compilazione rilasciata dopo la data di sottoscrizione della licenza) | No — LicenseException su ogni apertura | — | — |
Una licenza a pagamento la cui data di sottoscrizione è passata continua a funzionare — pulita, con le sue funzionalità — su ogni compilazione rilasciata prima di quella data. Solo una compilazione 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 pulita sulle compilazioni che copre; ma distribuire una compilazione rilasciata dopo la data di sottoscrizione della licenza viene rifiutata e fallisce rapidamente con un
LicenseException, così la si cattura al deploy — non inviando silenziosamente output con filigrana. Quell'eccezione (daOpenDocumentAsync) porta la ragione daLicense.RejectionMessage.
Funzionalità
Doconut controlla la funzionalità opzionale tramite funzionalità. Copre le funzionalità integrate Ricerca e Annotazione e i plugin opzionali Convertitore, Dicom e Firmatario, ciascuno concesso dalla tua licenza. Il visualizzatore di base non è una funzionalità — è il prerequisito, esposto come IsViewerLicensed:
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // licenza non-TRIAL presente E che copre la versione di questa build’sIl singolo gate che l'intera pipeline utilizza è IsCapabilityGranted:
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 ogni funzionalità — incluse le funzionalità che non hanno ancora un flag di acquisto dedicato; una licenza reale acquistata concede esattamente i suoi flag Has* e ha un comportamento negazione predefinita per tutto ciò che non è mappato. (Un file legacy di tipo TRIAL non è un diritto — viene trattato come non licenziato: con filigrana, nulla concesso.)
Licenze temporanee
Le licenze temporanee (Sviluppatore/NFR) sono contrassegnate da un tag ExpiryNote e hanno una data di scadenza rigida:
| Membro | Significato |
|---|---|
IsTemporary | È presente un tag ExpiryNote (il rilevamento avviene per presenza del tag — non corrisponde mai al testo della nota, è dinamico) |
ExpiryNote | Testo informativo incorporato nella licenza |
LicenseExpiry | La data di scadenza rigida (DateTime?) |
La semantica della scadenza varia per livello: una licenza temporanea scade alla sua LicenseExpiry solo data (la sua finestra di sottoscrizione è ignorata; una licenza temporanea priva della data è trattata come scaduta, in modalità sicurezza di fallimento). 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 compilazioni rilasciate prima rimangono pulite e mantengono le loro funzionalità.
Riferimento IDoconutLicenseService
Inietta IDoconutLicenseService (spazio dei nomi Doconut.Core.Interfaces; registrato come singleton — la licenza è analizzata una volta all'avvio):
| Membro | Significato |
|---|---|
License | Istantanea completa DoconutLicenseInfo (sotto) |
IsTrial | Un file legacy di tipo TRIAL (trattato come non licenziato — non è un diritto) |
IsTemporary / ExpiryNote / LicenseExpiry | Marcatori di licenza temporanea |
IsExpired | Scaduta secondo le regole di livello sopra |
IsVersionValid | Questa compilazione rientra nella finestra di supporto della licenza |
IsViewerLicensed | File non-TRIAL trovato e versione coperta — prerequisito di base |
IsCapabilityGranted(cap) | Il singolo gate di funzionalità |
HasSearch HasAnnotation HasEditor HasConverter HasDicom HasDocumentTools HasSigner HasRedactor HasComparer HasForms HasProtector HasCompressor | Un flag per funzionalità: acquistato da una licenza che copre questa compilazione, o concesso da una licenza Temporanea attiva. IsCapabilityGranted risponde alla stessa domanda per funzionalità |
IsValidForDomain(host) | Copertura host; le licenze V4 usano il carattere jolly *.* |
LicenseRejectionReason | Non 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.
// Imposta un Feature-flag alla 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 attraverso 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. 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 sarà rifiutato — la compilazione corrente continua a renderizzare pulita.
Aggiornamenti di versione
Una licenza copre una finestra di versione. Aggiornare il pacchetto NuGet a una compilazione più recente di quella finestra rende la licenza non valida per questa compilazione: IsVersionValid trasforma false e l'apertura è bloccata con un LicenseException (il motivo è in License.RejectionMessage) — fallimento rapido deliberato, così una compilazione obsoleta o non licenziata viene catturata al deploy invece di aggiungere silenziosamente filigrane all'output di produzione. Rinnova l'abbonamento, sostituisci il .lic, e riavvia l'applicazione così AddDoconut() carica la nuova licenza.
Questa pagina è stata utile?