Licencování
Schopnosti, licence úrovně a licenční služba
Tato stránka je referenční příručka za běhu, jak licence ovlivňuje chování Doconut: co umožňuje každý stav licence, jak jsou přiděleny schopnosti a jak to vše zkontrolovat 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 | Schopnosti |
|---|---|---|---|
| Plná (placená) licence (tato sestavení 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í přidělení (evaluační kanál) |
Vypršená dočasná licence (po datu LicenseExpiry) | Ano | Evaluační vodoznak | Žádná přidělena |
| Žádný licenční soubor | Ano | Evaluační vodoznak | Žádná přidělena |
| Nalezena, ale odmítnuta (neplatný podpis, poškozená, na černé listině, nebo sestavení 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ém sestavení vydaném před tímto datem. Pouze sestavení vydané po tomto datu je odmítnuto.
Dvě důsledky, které stojí za to si osvojit:
- 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ý, 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 vykresluje čistě na sestaveních, která pokrývá; ale nasazení sestavení vydaného 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. Výjimka (zOpenDocumentAsync) nese důvod zLicense.RejectionMessage.
Schopnosti
Doconut omezuje volitelnou funkčnost pomocí schopnosti. Pokrývá vestavěné funkce Search a Annotation a volitelné pluginy Converter, Dicom a Signer, z nichž každá je přidělena vaší licencí. Základní prohlížeč není schopnost — 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 celý pipeline používá, 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 přiděluje každou schopnost — včetně schopností, které ještě nemají dedikovaný nákupní příznak; skutečná zakoupená licence přiděluje přesně své Has* příznaky a je defaultně odmítnutá 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 nepřiděleno.)
Dočasné licence
Dočasné (Developer/NFR) licence jsou označeny značkou ExpiryNote a mají pevné datum vypršení:
| Člen | Význam |
|---|---|
IsTemporary | Značka ExpiryNote je přítomna (detekce probíhá podle přítomnosti značky — 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 — sestavení vydaná před tímto datem zůstávají čistá a zachovávají své schopnosti.
Referenční příručka IDoconutLicenseService
Injektujte IDoconutLicenseService (namespace Doconut.Core.Interfaces; registrováno jako singleton — licence je parsována jednou při startu):
| Č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 | Toto sestavení 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 schopnosti |
HasSearch HasAnnotation HasEditor HasConverter HasDicom HasDocumentTools HasSigner HasRedactor HasComparer HasForms HasProtector HasCompressor | Jeden příznak na schopnost: zakoupeno licencí, která pokrývá toto sestavení, nebo přiděleno 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írání je blokováno touto zprávou |
DoconutLicenseInfo vystavuje uživatelsky přívětivý snímek pro admin 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ý používá 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,
}));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 změní na upozornění 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 tomto datu bude odmítnut — aktuální sestavení zůstává čisté.
Aktualizace verzí
Licence pokrývá okno verze. Aktualizace NuGet balíčku na sestavení novější než toto okno způsobí, že licence je pro toto sestavení 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é sestavení je zachyceno při nasazení místo tiše vodoznakování produkčního výstupu. Obnovte předplatné, nahraďte .lic a restartujte aplikaci, aby AddDoconut() načetl novou licenci.
Byla tato stránka užitečná?