Licencování
Schopnosti, úrovně licencí a licenční služba
Tato stránka je referenční příručkou za běhu, jak licence ovlivňuje chování Doconut: co umožňuje každý stav licence, jak jsou přidělovány schopnosti a jak to všechno zkontrolovat v kódu. (Pro načítání licence viz Nastavení licence.)
Stavy licence a co dělají
| Stav | Otevírá dokumenty? | Vodoznak | Schopnosti |
|---|---|---|---|
| Plná (placená) licence (tato verze byla vydána před datem předplatného) | Ano | Žádný | Ty, které byly zakoupeny (Has* příznaky) |
| Dočasná licence (Developer/NFR — evaluační licence, před datem vypršení) | Ano | Žádný v základním prohlížeči; výstup pluginu je opatřen vodoznakem | Vše — plošné udělení (evaluační kanál) |
Vypršená dočasná licence (po datu LicenseExpiry) | Ano | Evaluační vodoznak | Žádné uděleno |
| Žádný licenční soubor vůbec | Ano | Evaluační vodoznak | Žádné uděleno |
| Nalezena, ale odmítnuta (neplatný podpis, poškozena, na černé listině, nebo verze vydaná po datu předplatného licence) | Ne — LicenseException při každém otevření | — | — |
Placená licence, jejíž datum předplatného uplynulo, nadále funguje — čistě, se svými schopnostmi — na každé verzi vydané před tímto datem. Pouze verze vydaná po tomto datu je odmítnuta.
Dvě důsledky, které stojí za to internalizovat:
- Chybějící licence není dočasná licence. Bez licenčního souboru jsou stránky zobrazovány s vodoznakem a žádná schopnost (vyhledávání, anotace, pluginy) není aktivní. Plnohodnotný, bezvodoznakový zážitek vyžaduje skutečnou Dočasnou licenci (získat ji).
- Pouze odmítnutá licence blokuje otevírání. Vypršená Dočasná licence ponechává aplikaci běžet s evaluačním vodoznakem a placená licence po datu předplatného nadále zobrazuje čistý výstup na verzích, které pokrývá; ale nasazení verze vydané po datu předplatného licence je odmítnuto a rychle selže s
LicenseException, takže ji zachytíte při nasazení — ne tiše odesíláním výstupu s vodoznakem. Tato výjimka (zOpenDocumentAsync) nese důvod zLicense.RejectionMessage.
Schopnosti
Doconut omezuje volitelnou funkčnost pomocí schopnosti. Pokrývá vestavěné funkce Vyhledávání a Anotace a volitelné pluginy Converter, Dicom a Signer, z nichž každý je udělen vaší licencí. Základní prohlížeč není schopnost — je předpokladem, zobrazeným jako IsViewerLicensed:
var lic = Doconut.DoconutHost.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // non-TRIAL licence přítomna A pokrývající verzi tohoto builduJediná brána, kterou celý pipeline používá, je IsCapabilityGranted:
var lic = Doconut.DoconutHost.Services.GetRequiredService<IDoconutLicenseService>();
bool searchGranted = lic.IsCapabilityGranted(LicenseCapability.Search);Jeho logika, doslovně z implementace: aktivní (nevypršená) Dočasná licence uděluje všechny schopnosti — včetně těch, které ještě nemají dedikovaný nákupní příznak; skutečná zakoupená licence uděluje přesně své Has* příznaky a je defaultně zamítnutá pro vše, co není přiřazeno. (Legacy soubor typu TRIAL není oprávněním — je považován za nelicencovaný: s vodoznakem, nic není uděleno.)
Dočasné licence
Dočasné (Developer/NFR) licence jsou označeny tagem ExpiryNote a mají pevné datum vypršení:
| Člen | Význam |
|---|---|
IsTemporary | Tag ExpiryNote je přítomen (detekce probíhá podle přítomnosti tagu — nikdy neporovnávat text poznámky, je dynamický) |
ExpiryNote | Informační text vložený do licence |
LicenseExpiry | Pevné datum vypršení (DateTime?) |
Semantika vypršení se liší podle úrovně: dočasná licence vyprší k datu LicenseExpiry pouze datum (její okno předplatného se ignoruje; dočasná licence bez data je považována za vypršenou, bezpečnostní režim). Všechny ostatní licence vyprší k datu svého předplatného/okna aktualizace; u placené licence IsExpired pouze hlásí, že toto datum uplynulo — verze vydané před tímto datem zůstávají čisté a zachovávají své schopnosti.
IDoconutLicenseService referenční informace
Vyřešte IDoconutLicenseService (namespace Doconut.Core.Interfaces) z DoconutHost.Services. Jedná se o singleton — licence je parsována jednou, v DoconutHost.Initialize:
| Člen | Význam |
|---|---|
License | Úplný DoconutLicenseInfo snímek (níže) |
IsTrial | Legacy soubor typu TRIAL (považován za nelicencovaný — není oprávněním) |
IsTemporary / ExpiryNote / LicenseExpiry | Značky dočasné licence |
IsExpired | Vypršela podle výše uvedených pravidel úrovně |
IsVersionValid | Tato sestavení spadají do podpůrného okna licence |
IsViewerLicensed | Nalezen soubor, který není TRIAL a verze je pokryta — základní předpoklad |
IsCapabilityGranted(cap) | Jediná brána schopnosti |
HasSearch HasAnnotation HasEditor HasConverter HasDicom HasDocumentTools HasSigner HasRedactor HasComparer HasForms HasProtector HasCompressor | Jedna vlajka na schopnost: zakoupena licencí, která pokrývá tuto sestavu, nebo udělena aktivní dočasnou licencí. IsCapabilityGranted odpovídá na stejnou otázku podle schopnosti |
IsValidForDomain(host) | Pokrytí hostitele; licence V4 používají zástupný znak *.* |
LicenseRejectionReason | Neprázdné ⇒ otevření je blokováno touto zprávou |
DoconutLicenseInfo poskytuje zobrazení přátelského snímku pro administrátorské panely: Owner, LicenseType, Domain, IsLicenseFileFound, IsVersionValid, IsTrial, IsExpired, vlajky Has*, pole dočasné licence a RejectionMessage.
// GET /Features - použijte feature-flag ve svém UI ze stejného zdroje pravdy, který používá 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);
}Kontrola zdraví
Doconut registruje "doconut" kontrolu zdraví, která hlásí stav licence. Classic ASP.NET nemá vlastní koncový bod zdraví, takže jej vystavte z kontroleru:
// GET /Health - Doconut registruje kontrolu zdraví "doconut", která hlásí stav licence:
// Zdravý (platný), Degradovaný (zkušební nebo chybí licenční soubor), Nezdravý (odmítnutý nebo vypršelý).
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");
}Zapojte ji do svého monitoringu a vypršející předplatné se stane upozorněním místo tiketů podpory. Kontrola hlásí Unhealthy, když je licence odmítnuta, nebo když je pravda IsExpired; pro placenou licenci to znamená, že datum předplatného uplynulo a balíček vydaný po tomto datu bude odmítnut — aktuální sestavení se nadále vykresluje čistě. Viz DoconutHost pro hodnoty stavů.
Aktualizace verzí
Licence pokrývá okno verzí. Aktualizace balíčku NuGet na sestavení novější než toto okno způsobí, že licence pro toto sestavení není platná: IsVersionValid mění false a otevření je blokováno pomocí LicenseException (důvod je v License.RejectionMessage) — úmyslně selže rychle, aby se zastaralé nebo nelicencované sestavení zachytilo při nasazení místo tichého vodoznaku ve výrobním výstupu. Obnovte předplatné, nahraďte .lic v wwwroot a recyklujte aplikační pool, aby DoconutHost.Initialize načetl novou licenci.
Byla tato stránka užitečná?