Licencování

Schopnosti, ú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 přidělovány schopnosti a jak to všechno zkontrolovat v kódu. (Pro načítání licence viz Nastavení licence.)

Stavy licence a co dělají

StavOtevírá dokumenty?VodoznakSchopnosti
Plná (placená) licence (tato verze 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é udělení (evaluační kanál)
Vypršená dočasná licence (po datu LicenseExpiry)AnoEvaluační vodoznakŽádné uděleno
Žádný licenční soubor vůbecAnoEvaluač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 schopnostmi — 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 to internalizovat:

  • 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ý, bezvodoznakový zážitek vyžaduje skutečnou Dočasnou licenci (získat ji).
  • Pouze odmítnutá licence blokuje otevírání. Vypršená Dočasná licence ponechává aplikaci běžet s evaluačním vodoznakem a placená licence po datu předplatného nadále zobrazuje čistý výstup 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 ji 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.

Schopnosti

Doconut omezuje volitelnou funkčnost pomocí schopnosti. Pokrývá vestavěné funkce Vyhledávání a Anotace a volitelné pluginy Converter, Dicom a Signer, z nichž každý je udělen vaší licencí. Základní prohlížeč není schopnost — je předpokladem, zobrazeným jako IsViewerLicensed:

csharp
var lic = Doconut.DoconutHost.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // non-TRIAL licence přítomna A pokrývající verzi tohoto buildu

Jediná brána, kterou celý pipeline používá, je IsCapabilityGranted:

csharp
var lic = Doconut.DoconutHost.Services.GetRequiredService<IDoconutLicenseService>();
bool searchGranted = lic.IsCapabilityGranted(LicenseCapability.Search);

Jeho logika, doslovně z implementace: aktivní (nevypršená) Dočasná licence uděluje všechny schopnosti — včetně těch, které ještě nemají dedikovaný nákupní příznak; skutečná zakoupená licence uděluje přesně své Has* příznaky a je defaultně zamítnutá pro vše, co není přiřazeno. (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 datu LicenseExpiry pouze datum (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 svého předplatného/okna aktualizace; u placené licence IsExpired pouze hlásí, že toto datum uplynulo — verze vydané před tímto datem zůstávají čisté a zachovávají své schopnosti.

IDoconutLicenseService referenční informace

Vyřešte IDoconutLicenseService (namespace Doconut.Core.Interfaces) z DoconutHost.Services. Jedná se o singleton — licence je parsována jednou, v DoconutHost.Initialize:

Č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ě
IsVersionValidTato sestavení spadají 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 HasCompressorJedna vlajka na schopnost: zakoupena licencí, která pokrývá tuto sestavu, nebo udělena 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ření je blokováno touto zprávou

DoconutLicenseInfo poskytuje zobrazení přátelského snímku pro administrátorské panely: Owner, LicenseType, Domain, IsLicenseFileFound, IsVersionValid, IsTrial, IsExpired, vlajky Has*, pole dočasné licence a RejectionMessage.

csharp
// GET /Features - použijte feature-flag ve svém UI ze stejného zdroje pravdy, který používá SDK
public ActionResult Index()
{
    var lic = Doconut.DoconutHost.Services.GetRequiredService<IDoconutLicenseService>();

    return Json(new
    {
        viewer     = lic.IsViewerLicensed || lic.IsTemporary,
        search     = lic.IsCapabilityGranted(LicenseCapability.Search),
        annotation = lic.IsCapabilityGranted(LicenseCapability.Annotation),
        conversion = lic.HasConverter,
        dicom      = lic.HasDicom,
    }, JsonRequestBehavior.AllowGet);
}

Kontrola zdraví

Doconut registruje "doconut" kontrolu zdraví, která hlásí stav licence. Classic ASP.NET nemá vlastní koncový bod zdraví, takže jej vystavte z kontroleru:

csharp
// GET /Health - Doconut registruje kontrolu zdraví "doconut", která hlásí stav licence:
// Zdravý (platný), Degradovaný (zkušební nebo chybí licenční soubor), Nezdravý (odmítnutý nebo vypršelý).
public async Task<ActionResult> Index()
{
    var health = Doconut.DoconutHost.Services.GetRequiredService<HealthCheckService>();
    HealthReport report = await health.CheckHealthAsync();

    Response.StatusCode = report.Status == HealthStatus.Unhealthy ? 503 : 200;
    return Content(report.Status.ToString(), "text/plain");
}

Zapojte ji do svého monitoringu a vypršející předplatné se stane upozorněním místo tiketů podpory. Kontrola hlásí Unhealthy, když je licence odmítnuta, nebo když je pravda IsExpired; pro placenou licenci to znamená, že datum předplatného uplynulo a balíček vydaný po tomto datu bude odmítnut — aktuální sestavení se nadále vykresluje čistě. Viz DoconutHost pro hodnoty stavů.

Aktualizace verzí

Licence pokrývá okno verzí. Aktualizace balíčku NuGet na sestavení novější než toto okno způsobí, že licence pro toto sestavení není platná: IsVersionValid mění false a otevření je blokováno pomocí LicenseException (důvod je v License.RejectionMessage) — úmyslně selže rychle, aby se zastaralé nebo nelicencované sestavení zachytilo při nasazení místo tichého vodoznaku ve výrobním výstupu. Obnovte předplatné, nahraďte .lic v wwwroot a recyklujte aplikační pool, aby DoconutHost.Initialize načetl novou licenci.

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