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 il caricamento di una licenza, vedere Impostazione della licenza.)
Stati della licenza e cosa fanno
| Stato | Apre documenti? | Filigrana | Funzionalità |
|---|---|---|---|
| Licenza completa (a pagamento) (questa build è stata rilasciata prima della sua data di sottoscrizione) | Sì | Nessuna | Quelle acquistate (Has* flag) |
| Licenza temporanea (Sviluppatore/NFR — la licenza di valutazione, prima della sua data di scadenza) | Sì | Nessuna nel visualizzatore di base; l'output del plugin è filigranato | Tutte — concessione totale (il funnel di valutazione) |
Licenza temporanea scaduta (oltre la sua 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 vera Licenza temporanea (ottienine 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 rendere pulito le 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) contiene il motivo daLicense.RejectionMessage.
Funzionalità
Doconut controlla le funzionalità opzionali tramite funzionalità. Copre le funzionalità 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 = Doconut.DoconutHost.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 = Doconut.DoconutHost.Services.GetRequiredService<IDoconutLicenseService>();
bool searchGranted = lic.IsCapabilityGranted(LicenseCapability.Search);La sua logica, parola per parola dall'implementazione: una licenza Temporary 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 elemento 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 (Developer/NFR) sono contrassegnate da un tag ExpiryNote e hanno una data di scadenza rigida:
| Membro | Significato |
|---|---|
IsTemporary | È presente un tag ExpiryNote (la rilevazione avviene per presenza del tag — mai confrontare 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, a prova di errore). 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 di essa rimangono pulite e mantengono le loro funzionalità.
Riferimento a IDoconutLicenseService
Risolvi IDoconutLicenseService (namespace Doconut.Core.Interfaces) da DoconutHost.Services. È un singleton — la licenza viene analizzata una sola volta, in DoconutHost.Initialize:
| Membro | Significato |
|---|---|
License | Snapshot completo di DoconutLicenseInfo (sotto) |
IsTrial | Un file legacy di tipo TRIAL (trattato come non licenziato — non è un diritto) |
IsTemporary / ExpiryNote / LicenseExpiry | Marcatori di licenza temporanea |
IsExpired | Scaduto 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 capacità |
HasSearch HasAnnotation HasEditor HasConverter HasDicom HasDocumentTools HasSigner HasRedactor HasComparer HasForms HasProtector HasCompressor | Un flag per capacità: acquistato da una licenza che copre questa build, o concesso da una licenza Temporanea attiva. IsCapabilityGranted risponde alla stessa domanda per capacità |
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 di licenza temporanea, e RejectionMessage.
// GET /Features - abilita le feature della tua UI dalla stessa fonte di verità usata dall'SDK
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);
}Controllo di salute
Doconut registra un controllo di salute "doconut" che riporta lo stato della licenza. Classic ASP.NET non ha un endpoint di salute proprio, quindi esponilo da un controller:
// GET /Health - Doconut registra un controllo di salute "doconut" che riporta lo stato della licenza:
// Sano (valido), Degradato (di prova o nessun file di licenza), Non sano (rifiutato o scaduto).
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");
}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 abbonamento è passata e un pacchetto rilasciato dopo verrà rifiutato — la build corrente continua a renderizzare correttamente. Vedi DoconutHost per i valori di stato.
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 aggiungere silenziosamente un watermark all'output di produzione. Rinnova l'abbonamento, sostituisci il .lic in wwwroot, e ricicla il pool dell'applicazione così DoconutHost.Initialize carica la nuova licenza.
Questa pagina è stata utile?