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í

StavOtevírá dokumenty?VodoznakFunkce
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 vodoznakemVše — všeobecné udělení (evaluační kanál)
Vypršená dočasná licence (po datu LicenseExpiry)AnoEvaluační vodoznakŽádné uděleno
Žádný licenční souborAnoEvaluač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 (z OpenDocumentAsync) nese důvod z License.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:

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

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

ČlenVýznam
IsTemporaryTag ExpiryNote je přítomen (detekce probíhá podle přítomnosti tagu — nikdy neporovnávat text poznámky, je dynamické)
ExpiryNoteInformační text vložený do licence
LicenseExpiryPevné 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):

ČlenVýznam
LicenseÚplný DoconutLicenseInfo snapshot (níže)
IsTrialLegacy soubor typu TRIAL (považován za nelicencovaný — není oprávněním)
IsTemporary / ExpiryNote / LicenseExpiryMarkery dočasné licence
IsExpiredVypršela podle výše uvedených pravidel úrovně
IsVersionValidTato verze spadá do podpůrného okna licence
IsViewerLicensedNalezen 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 HasCompressorJeden 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 *.*
LicenseRejectionReasonNení 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.

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

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