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

StatoApre documenti?FiligranaFunzionalità
Licenza completa (a pagamento) (questa build è stata rilasciata prima della sua data di sottoscrizione)SìNessunaQuelle 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 è filigranatoTutte — concessione totale (il funnel di valutazione)
Licenza temporanea scaduta (oltre la sua 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 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 (da OpenDocumentAsync) contiene il motivo da License.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:

csharp
var lic = Doconut.DoconutHost.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 = 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:

MembroSignificato
IsTemporaryÈ presente un tag ExpiryNote (la rilevazione avviene per presenza del tag — mai confrontare 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, 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:

MembroSignificato
LicenseSnapshot completo di DoconutLicenseInfo (sotto)
IsTrialUn file legacy di tipo TRIAL (trattato come non licenziato — non è un diritto)
IsTemporary / ExpiryNote / LicenseExpiryMarcatori di licenza temporanea
IsExpiredScaduto 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 capacità
HasSearch HasAnnotation HasEditor HasConverter HasDicom HasDocumentTools HasSigner HasRedactor HasComparer HasForms HasProtector HasCompressorUn 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 *.*
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 di licenza temporanea, e RejectionMessage.

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

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