Licencjonowanie
Funkcje, poziomy licencji i usługa licencji
Ta strona jest odniesieniem w czasie działania, opisującym, jak licencja kształtuje zachowanie Doconut: co pozwala każdy stan licencji, jak przyznawane są funkcje i jak sprawdzić to wszystko z kodu. (Aby wczytać licencję, zobacz Konfiguracja licencji.)
Stany licencji i ich działanie
| Stan | Otwiera dokumenty? | Znak wodny | Funkcje |
|---|---|---|---|
| Pełna (płatna) licencja (ta kompilacja została wydana przed datą subskrypcji) | Tak | Brak | Te zakupione (Has* flagi) |
| Tymczasowa licencja (Developer/NFR — licencja ewaluacyjna, przed datą wygaśnięcia) | Tak | Brak w podstawowym przeglądarce; wyjście wtyczki jest znakowane | Wszystkie — pełne przyznanie (kanał ewaluacji) |
Wygasła tymczasowa licencja (po dacie LicenseExpiry) | Tak | Znak wodny ewaluacji | Brak przyznanych |
| Brak pliku licencji | Tak | Znak wodny ewaluacji | Brak przyznanych |
| Znaleziono, ale odrzucono (nieprawidłowy podpis, manipulacja, na czarnej liście lub kompilacja wydana po dacie subskrypcji licencji) | Nie — LicenseException przy każdym otwarciu | — | — |
Płatna licencja, której data subskrypcji minęła, nadal działa — czysto, z jej funkcjami — na każdej kompilacji wydanej przed tą datą. Tylko kompilacja wydana po tej dacie jest odrzucana.
Dwa wnioski warte zapamiętania:
- Brak licencji nie jest licencją tymczasową. Bez pliku licencji strony są wyświetlane ze znakiem wodnym i żadna funkcja (wyszukiwanie, adnotacje, wtyczki) nie jest aktywna. Pełne, nieoznaczone znakiem wodnym doświadczenie wymaga rzeczywistej Tymczasowej licencji (zdobądź ją).
- Tylko odrzucona licencja blokuje otwieranie. Wygasła Tymczasowa licencja utrzymuje aplikację w działaniu ze znakiem wodnym ewaluacji, a płatna licencja po dacie subskrypcji pozostaje czysta na kompilacjach, które obejmuje; jednak wdrożenie kompilacji wydanej po dacie subskrypcji licencji jest odrzucane i szybko kończy się niepowodzeniem z
LicenseException, więc wykrywasz to przy wdrożeniu — a nie przez ciche dostarczanie wyjścia ze znakiem wodnym. Ten wyjątek (zOpenDocumentAsync) zawiera powód zLicense.RejectionMessage.
Funkcje
Doconut ogranicza opcjonalną funkcjonalność za pomocą funkcji. Obejmuje wbudowane funkcje Wyszukiwanie i Adnotacje oraz opcjonalne wtyczki Konwerter, Dicom i Signer, każda przyznawana na podstawie twojej licencji. Podstawowy podgląd nie jest funkcją — jest warunkiem wstępnym, udostępnionym jako IsViewerLicensed:
var lic = Doconut.DoconutHost.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // licencja non-TRIAL jest obecna ORAZ obejmuje wersję tego builduJedyną bramą, której używa cały potok, jest IsCapabilityGranted:
var lic = Doconut.DoconutHost.Services.GetRequiredService<IDoconutLicenseService>();
bool searchGranted = lic.IsCapabilityGranted(LicenseCapability.Search);Jej logika, dosłownie z implementacji: aktywna (nieprzeterminowana) Tymczasowa licencja przyznaje wszystkie funkcje — w tym funkcje, które jeszcze nie mają dedykowanej flagi zakupu; rzeczywista zakupiona licencja przyznaje dokładnie swoje flagi Has* i ma domyślne odrzucenie dla wszystkiego, co nie jest zmapowane. (Plik typu TRIAL z przeszłości nie jest uprawnieniem — jest traktowany jako nielicencjonowany: znakowany, nic nie przyznane.)
Tymczasowe licencje
Tymczasowe licencje (Developer/NFR) są oznaczone tagiem ExpiryNote i mają sztywną datę wygaśnięcia:
| Członek | Znaczenie |
|---|---|
IsTemporary | Tag ExpiryNote jest obecny (detekcja odbywa się na podstawie obecności tagu — nigdy nie dopasowuje się do tekstu notatki, jest dynamiczna) |
ExpiryNote | Tekst informacyjny wbudowany w licencję |
LicenseExpiry | Sztywna data wygaśnięcia (DateTime?) |
Semantyka wygaśnięcia różni się w zależności od poziomu: tymczasowa licencja wygasa w dniu LicenseExpiry tylko daty (okno subskrypcji jest ignorowane; tymczasowa licencja bez daty jest traktowana jako wygasła, zabezpieczenie). Wszystkie inne licencje wygasają w dniu subskrypcji/okna aktualizacji; w przypadku płatnej licencji, IsExpired jedynie informuje, że ta data minęła — kompilacje wydane przed nią pozostają czyste i zachowują swoje funkcje.
IDoconutLicenseService referencja
Rozwiąż IDoconutLicenseService (przestrzeń nazw Doconut.Core.Interfaces) z DoconutHost.Services. Jest to singleton — licencja jest parsowana raz, w DoconutHost.Initialize:
| Członek | Znaczenie |
|---|---|
License | Pełna migawka DoconutLicenseInfo (poniżej) |
IsTrial | Plik typu TRIAL w wersji legacy (traktowany jako nielicencjonowany — nie jest uprawnieniem) |
IsTemporary / ExpiryNote / LicenseExpiry | Znaczniki tymczasowej licencji |
IsExpired | Wygasło zgodnie z powyższymi zasadami poziomu |
IsVersionValid | Ta wersja mieści się w oknie wsparcia licencji |
IsViewerLicensed | Znaleziono plik nie-TRIAL i wersja objęta — podstawowy warunek wstępny |
IsCapabilityGranted(cap) | Jedyna bramka możliwości |
HasSearch HasAnnotation HasEditor HasConverter HasDicom HasDocumentTools HasSigner HasRedactor HasComparer HasForms HasProtector HasCompressor | Jedna flaga na możliwość: zakupiona przez licencję obejmującą tę wersję, lub przyznana przez aktywną tymczasową licencję. IsCapabilityGranted odpowiada na to samo pytanie według możliwości |
IsValidForDomain(host) | Pokrycie hosta; licencje V4 używają wieloznacznika *.* |
LicenseRejectionReason | Niepusty ⇒ otwieranie jest blokowane z tym komunikatem |
DoconutLicenseInfo udostępnia przyjazną dla wyświetlania migawkę dla paneli administracyjnych: Owner, LicenseType, Domain, IsLicenseFileFound, IsVersionValid, IsTrial, IsExpired, flagi Has*, pola tymczasowej licencji oraz RejectionMessage.
// GET /Features - ustaw flagę funkcji w UI z tego samego źródła prawdy, którego używa 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);
}Sprawdzenie stanu
Doconut rejestruje "doconut" sprawdzenie stanu, które raportuje stan licencji. Classic ASP.NET nie posiada własnego punktu końcowego stanu, więc udostępnij je z kontrolera:
// GET /Health - Doconut rejestruje kontrolę stanu zdrowia "doconut", która raportuje stan licencji:
// Zdrowy (prawidłowy), Obniżony (wersja próbna lub brak pliku licencji), Niezdrowy (odrzucona lub wygasła).
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");
}Podłącz to do swojego monitoringu, a wygasająca subskrypcja stanie się alertem zamiast zgłoszenia wsparcia. Sprawdzenie raportuje Unhealthy gdy licencja jest odrzucona lub IsExpired jest prawdziwe; w przypadku płatnej licencji oznacza to, że data subskrypcji minęła i pakiet wydany po niej zostanie odrzucony — bieżąca wersja pozostaje czysta. Zobacz DoconutHost po wartości statusu.
Uaktualnienia wersji
Licencja obejmuje okno wersji. Aktualizacja pakietu NuGet do wersji nowszej niż to okno powoduje, że licencja jest nieważna dla tej wersji: IsVersionValid zmienia false i otwieranie jest blokowane przy użyciu LicenseException (powód znajduje się w License.RejectionMessage) — celowo szybka awaria, aby przestarzała lub nielicencjonowana wersja została wykryta przy wdrożeniu, a nie cicho znakowana w produkcji. Odnów subskrypcję, zamień .lic w wwwroot i zresetuj pulę aplikacji, aby DoconutHost.Initialize załadował nową licencję.
Czy ta strona była pomocna?