Licencování
Funkce, ú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 funkce udělovány a jak si je lze prohlédnout z kódu. (Pro načítání licence viz Začínáme → Nastavení licence.)
Stavy licence a co dělají
| Stav | Otevírá dokumenty? | Vodoznak | Funkce |
|---|---|---|---|
| Plná (placená) licence (tato verze byla vydána před datem předplatného) | Ano | Žádný | Ty, které byly zakoupeny (Has* flags) |
| 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 — všeobecné 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 | 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 funkcemi — 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 zapamatování:
- Chybějící licence není dočasná licence. Bez licenčního souboru jsou stránky zobrazovány s vodoznakem a žádná funkce (vyhledávání, anotace, pluginy) není aktivní. Plnohodnotný, bez vodoznaku, zážitek vyžaduje skutečnou Dočasnou licenci (získat jednu).
- Pouze odmítnutá licence blokuje otevírání. Vypršená Dočasná licence udržuje aplikaci běžící s evaluačním vodoznakem a placená licence po datu předplatného nadále zobrazuje čistě 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 to 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.
Funkce
Doconut omezuje volitelnou funkčnost pomocí funkce. Pokrývá vestavěné funkce Search a Annotation a volitelné pluginy Converter, Dicom a Signer, z nichž každá je udělena vaší licencí. Základní prohlížeč není funkcí — je předpokladem, zobrazeným jako IsViewerLicensed:
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // non-TRIAL licence je přítomna A pokrývá verzi tohoto sestaveníJedna brána, kterou používá celý pipeline, je IsCapabilityGranted:
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool searchGranted = lic.IsCapabilityGranted(LicenseCapability.Search);Jeho logika, doslovně z implementace: aktivní (nevypršená) Dočasná licence uděluje každou funkci — včetně funkcí, které ještě nemají dedikovaný nákupní příznak; skutečná zakoupená licence uděluje přesně své Has* příznaky a je defaultně odmítavá pro vše, co není mapováno. (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 jejímu LicenseExpiry pouze datu (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 jejich předplatného/okna aktualizace; pro placenou licenci IsExpired pouze hlásí, že toto datum uplynulo — verze vydané před tím zůstávají čisté a zachovávají své funkce.
Referenční dokumentace IDoconutLicenseService
Injektujte IDoconutLicenseService (namespace Doconut.Core.Interfaces; registrovaný jako singleton — licence je parsována jednou při startu):
| Člen | Význam |
|---|---|
License | Úplný DoconutLicenseInfo snapshot (níže) |
IsTrial | Legacy soubor typu TRIAL (považován za nelicencovaný — není oprávněním) |
IsTemporary / ExpiryNote / LicenseExpiry | Markery dočasné licence |
IsExpired | Vypršela podle výše uvedených pravidel úrovně |
IsVersionValid | Tato verze spadá 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 funkce |
HasSearch HasAnnotation HasEditor HasConverter HasDicom HasDocumentTools HasSigner HasRedactor HasComparer HasForms HasProtector HasCompressor | Jeden příznak na funkci: zakoupený licencí, která pokrývá tuto verzi, nebo udělený aktivní Dočasnou licencí. IsCapabilityGranted odpovídá na stejnou otázku podle funkce |
IsValidForDomain(host) | Pokrytí hostitele; V4 licence používají zástupný znak *.* |
LicenseRejectionReason | Není prázdné ⇒ otevírání je blokováno touto zprávou |
DoconutLicenseInfo zpřístupňuje uživatelsky přívětivý snapshot pro administrátorské panely: Owner, LicenseType, Domain, IsLicenseFileFound, IsVersionValid, IsTrial, IsExpired, příznaky Has*, pole dočasné licence a RejectionMessage.
// Feature-flag vaše UI ze stejného zdroje pravdy, který SDK používá
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,
}));Kontrola zdraví
AddDoconut() registruje "doconut" kontrolu zdraví, která hlásí stav licence/vypršení přes standardní mechanismus ASP.NET Core:
app.MapHealthChecks("/health");Zapojte ji do svého monitoringu a vypršející předplatné se stane upozorněním místo ticketu podpory. Kontrola hlásí Unhealthy, když je licence odmítnuta, nebo je IsExpired pravda; pro placenou licenci to znamená, že datum předplatného uplynulo a balíček vydaný po něm bude odmítnut — aktuální verze nadále zobrazuje čistě.
Aktualizace verzí
Licence pokrývá okno verze. Aktualizace balíčku NuGet na verzi novější než toto okno způsobí, že licence pro tuto verzi je neplatná: IsVersionValid přemění false a otevírání je blokováno s LicenseException (důvod je v License.RejectionMessage) — úmyslně rychlé selhání, takže zastaralá nebo nelicencovaná verze je zachycena při nasazení místo tichého vodoznakování produkčního výstupu. Obnovte předplatné, vyměňte .lic a restartujte aplikaci, aby AddDoconut() načetl novou licenci.
Byla tato stránka užitečná?