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 každá stav licence umožňuje, jak jsou funkce udělovány a jak si to vše 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 zakoupené (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 vodoznakemVše — plošné 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 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 funkcemi — 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 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).
  • 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. Tato výjimka (z OpenDocumentAsync) nese důvod z License.RejectionMessage.

Funkce

Doconut omezuje volitelnou funkcionalitu 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; // licence non-TRIAL 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 značkou ExpiryNote a mají pevné datum vypršení:

ČlenVýznam
IsTemporaryZnačka ExpiryNote je přítomna (detekce probíhá podle přítomnosti značky — nikdy neodpovídá textu 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 okna předplatného/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é funkce.

Referenční informace IDoconutLicenseService

Injektujte IDoconutLicenseService (namespace Doconut.Core.Interfaces; registrováno jako singleton — licence je parsována jednou při spuštění):

ČlenVýznam
LicenseKompletní DoconutLicenseInfo snímek (níže)
IsTrialLegacy soubor typu TRIAL (považován za nelicencovaný — není oprávněním)
IsTemporary / ExpiryNote / LicenseExpiryZnačky dočasné licence
IsExpiredVypršela podle výše uvedených pravidel úrovně
IsVersionValidToto sestavení 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á toto sestavení, nebo udělený aktivní Dočasnou licencí. IsCapabilityGranted odpovídá na stejnou otázku podle funkce
IsValidForDomain(host)Pokrytí hostitele; licence V4 používají zástupný znak *.*
LicenseRejectionReasonNení prá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.

csharp
// 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í prostřednictvím standardního mechanismu 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 tomto datu bude odmítnut — aktuální sestavení zůstává čisté.

Aktualizace verzí

Licence pokrývá verzní okno. Aktualizace balíčku NuGet na sestavení novější než toto okno způsobí, že licence pro toto sestavení je neplatná: IsVersionValid mění false a otevírání je blokováno s LicenseException (důvod je v License.RejectionMessage) — úmyslně rychlé selhání, aby bylo zastaralé nebo nelicencované sestavení zachyceno při nasazení místo tiše vodotiskovat produkční výstup. Obnovte předplatné, nahraďte .lic a restartujte aplikaci, aby AddDoconut() načetl novou licenci.

Byla tato stránka užitečná?