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

StatoApre documenti?FiligranaFunzionalità
Licenza completa (a pagamento) (questa compilazione è stata rilasciata prima della sua data di sottoscrizione)SìNessunaLe 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 filigranaTutte — concessione totale (il funnel di valutazione)
Licenza temporanea scaduta (passata la data LicenseExpiry)SìFiligrana di valutazioneNessuna concessa
Nessun file di licenzaSìFiligrana di valutazioneNessuna 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 (da OpenDocumentAsync) porta la ragione da License.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:

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

Il singolo 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 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:

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 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):

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 compilazione rientra nella finestra di supporto della licenza
IsViewerLicensedFile 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 HasCompressorUn 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 *.*
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 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:

csharp
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?