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

StatoApre i 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 (passata la 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 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 (da OpenDocumentAsync) porta la ragione da License.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:

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

L'unico gate che utilizza l'intera pipeline è 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* 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:

MembroSignificato
IsTemporaryUn tag ExpiryNote è presente (la rilevazione avviene per presenza del tag — non confrontare mai il testo della nota, è dinamica)
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, 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):

MembroSignificato
LicenseSnapshot completo DoconutLicenseInfo (di seguito)
IsTrialUn file legacy di tipo TRIAL (trattato come non licenziato — non un diritto)
IsTemporary / ExpiryNote / LicenseExpiryMarker 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)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 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 lo snapshot visualizzabile per i pannelli admin: Owner, LicenseType, Domain, IsLicenseFileFound, IsVersionValid, IsTrial, IsExpired, i flag Has*, i campi della licenza temporanea, e RejectionMessage.

csharp
// 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:

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