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í

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

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 celý pipeline používá, 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 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í:

ČlenVýznam
IsTemporaryZnačka ExpiryNote je přítomna (detekce probíhá podle přítomnosti značky — 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 — 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):

ČlenVýznam
LicenseÚplný 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 schopnosti
HasSearch HasAnnotation HasEditor HasConverter HasDicom HasDocumentTools HasSigner HasRedactor HasComparer HasForms HasProtector HasCompressorJeden 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 *.*
LicenseRejectionReasonNeprá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í přes standardní mechanismus ASP.NET Core:

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