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 Getting Started → License Setup.)
Stati della licenza e cosa fanno
| Stato | Apre i documenti? | Filigrana | Funzionalità |
|---|---|---|---|
| Licenza completa (a pagamento) (questa build è stata rilasciata prima della sua data di sottoscrizione) | Sì | Nessuna | Quelle 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 è filigranato | 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, nella lista nera, o una build 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 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 reale 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 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 con filigrana. Quell'eccezione (daOpenDocumentAsync) porta la ragione daLicense.RejectionMessage.
Funzionalità
Doconut controlla la funzionalità opzionale tramite funzionalità. Copre le funzioni integrate Search e Annotation e i plugin opzionali Converter, Dicom e Signer, 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 buildL'unico gate che utilizza l'intera pipeline è 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 tutte le funzionalità — incluse quelle che non hanno ancora un flag di acquisto dedicato; una licenza reale acquistata 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, nulla concesso.)
Licenze temporanee
Le licenze temporanee (Developer/NFR) sono contrassegnate da un tag ExpiryNote e hanno una data di scadenza rigida:
| Membro | Significato |
|---|---|
IsTemporary | Un tag ExpiryNote è presente (la rilevazione avviene per presenza del tag — non confrontare mai il testo della nota, è dinamica) |
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 data LicenseExpiry (la sua finestra di sottoscrizione è ignorata; una licenza temporanea priva della data è trattata come scaduta, 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 volta all'avvio):
| Membro | Significato |
|---|---|
License | Snapshot completo DoconutLicenseInfo (di seguito) |
IsTrial | Un file legacy di tipo TRIAL (trattato come non licenziato — non un diritto) |
IsTemporary / ExpiryNote / LicenseExpiry | Marker di licenza temporanea |
IsExpired | Scaduta secondo le regole di livello sopra |
IsVersionValid | Questa build 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 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 *.* |
LicenseRejectionReason | Non vuoto ⇒ l'apertura è bloccata con questo messaggio |
DoconutLicenseInfo espone lo snapshot visualizzabile per i pannelli admin: Owner, LicenseType, Domain, IsLicenseFileFound, IsVersionValid, IsTrial, IsExpired, i flag Has*, i campi della licenza temporanea, e RejectionMessage.
// Feature-flag la 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:
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 verrà 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 (la ragione è 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 affinché AddDoconut() carichi la nuova licenza.
Questa pagina è stata utile?