Lisanslama
Yetenekler, lisans katmanları ve lisans hizmeti
Bu sayfa, bir lisansın Doconut'un davranışını nasıl şekillendirdiğine dair çalışma zamanı referansıdır: her lisans durumunun neyi izin verdiği, yeteneklerin nasıl verildiği ve bunların tümünün koddan nasıl inceleneceği. (Bir lisansı yüklemek için, Lisans Kurulumu bölümüne bakın.)
Lisans durumları ve ne yaptıkları
| Durum | Belge açar mı? | Filigran | Yetenekler |
|---|---|---|---|
| Tam (ücretli) lisans (bu yapı abonelik tarihinden önce yayınlandı) | Evet | Yok | Satın alınanlar (Has* bayrakları) |
| Geçici lisans (Geliştirici/NFR — değerlendirme lisansı, son tarihinden önce) | Evet | Temel görüntüleyicide yok; eklenti çıktısı filigranlı | Tümü — kapsamlı izin (değerlendirme hunisi) |
Süresi dolmuş geçici lisans (LicenseExpiry tarihinin geçmiş olması) | Evet | Değerlendirme filigranı | Hiçbir şey verilmedi |
| Hiç lisans dosyası yok | Evet | Değerlendirme filigranı | Hiçbir şey verilmedi |
| Bulundu ancak reddedildi (geçersiz imza, değiştirilmiş, kara listeye alınmış veya lisansın abonelik tarihinden sonra yayınlanan bir yapı) | Hayır — LicenseException her açmada | — | — |
Abonelik tarihi geçmiş bir ücretli lisans, o tarihten önce yayınlanan her yapı üzerinde — temiz, yetenekleriyle birlikte — çalışmaya devam eder. Sadece o tarihten sonra yayınlanan bir yapı reddedilir.
İçselleştirmeniz gereken iki sonuç:
- Eksik bir lisans geçici bir lisans değildir. Lisans dosyası olmadığında, sayfalar filigranlı olarak görüntülenir ve hiçbir yetenek (arama, açıklama, eklentiler) aktif değildir. Tam özellikli, filigransız deneyim gerçek bir Geçici lisans gerektirir (bir tane edinin).
- Yalnızca reddedilen bir lisans açmayı engeller. Süresi dolmuş bir Geçici lisans, uygulamayı değerlendirme filigranı ile çalışır durumda tutar ve abonelik tarihini geçmiş bir ücretli lisans, kapsadığı yapılar üzerinde temiz görüntülenmeye devam eder; ancak lisansın abonelik tarihinden sonra yayınlanan bir yapı dağıtıldığında reddedilir ve hızlı bir şekilde
LicenseExceptionile başarısız olur, böylece dağıtımda yakalarsınız — sessizce filigranlı çıktı göndererek değil. Bu istisna (OpenDocumentAsync'den)License.RejectionMessage'den gelen nedeni taşır.
Yetenekler
Doconut, isteğe bağlı işlevselliği yetenek ile kısıtlar. Bu, yerleşik Arama ve Açıklama özelliklerini ve isteğe bağlı Dönüştürücü, Dicom ve Signer eklentilerini kapsar; her biri lisansınız tarafından verilir. Temel görüntüleyici bir yetenek değildir — önkoşuldur ve IsViewerLicensed olarak ortaya çıkar:
var lic = Doconut.DoconutHost.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // non-TRIAL lisansı mevcut VE bu derlemenin sürümünü kapsıyorTüm işlem hattının kullandığı tek kapı IsCapabilityGranted:
var lic = Doconut.DoconutHost.Services.GetRequiredService<IDoconutLicenseService>();
bool searchGranted = lic.IsCapabilityGranted(LicenseCapability.Search);Mantığı, uygulamadan kelimesi kelimesine: aktif (süresi dolmamış) bir Geçici lisans tüm yetenekleri verir — henüz özel bir satın alma bayrağı olmayan yetenekler dahil; gerçek bir satın alınmış lisans tam olarak Has* bayraklarını verir ve eşlenmemiş her şey için varsayılan-red durumundadır. (Eski bir TRIAL-tipi dosya hak değildir — lisanssız olarak değerlendirilir: filigranlı, hiçbir şey verilmez.)
Geçici lisanslar
Geçici (Geliştirici/NFR) lisanslar bir ExpiryNote etiketiyle işaretlenir ve kesin bir son tarih taşır:
| Üye | Anlam |
|---|---|
IsTemporary | Bir ExpiryNote etiketi mevcut (algılama etiket varlığına göre yapılır — notun metniyle eşleşmez, dinamiktir) |
ExpiryNote | Lisansa gömülü bilgilendirici metin |
LicenseExpiry | Kesin son tarih (DateTime?) |
Son tarih anlamı katmana göre farklıdır: bir geçici lisans, sadece LicenseExpiry tarihi üzerine süresi dolar (abonelik penceresi yok sayılır; tarihi eksik bir geçici lisans süresi dolmuş olarak değerlendirilir, güvenli hata). Diğer tüm lisanslar abonelik/güncelleme penceresi tarihine göre süresi dolar; ücretli bir lisans için, IsExpired yalnızca bu tarihin geçtiğini rapor eder — ondan önce yayınlanan yapılar temiz kalır ve yeteneklerini korur.
IDoconutLicenseService referansı
IDoconutLicenseService öğesini (namespace Doconut.Core.Interfaces) from DoconutHost.Services üzerinden çözün. Bu bir singleton — lisans bir kez, DoconutHost.Initialize içinde ayrıştırılır:
| Üye | Anlam |
|---|---|
License | Tam DoconutLicenseInfo anlık görüntüsü (aşağıda) |
IsTrial | Legacy TRIAL-tipi dosya (lisanssız olarak kabul edilir — bir hak değildir) |
IsTemporary / ExpiryNote / LicenseExpiry | Geçici lisans işaretçileri |
IsExpired | Yukarıdaki seviye kurallarına göre süresi dolmuş |
IsVersionValid | Bu yapı, lisansın destek penceresi içinde yer alıyor |
IsViewerLicensed | Non-TRIAL dosyası bulundu ve sürüm kapsandı — temel ön koşul |
IsCapabilityGranted(cap) | Tek yetenek kapısı |
HasSearch HasAnnotation HasEditor HasConverter HasDicom HasDocumentTools HasSigner HasRedactor HasComparer HasForms HasProtector HasCompressor | Yeteneğe göre bir bayrak: bu yapıyı kapsayan bir lisans tarafından satın alınmış, ya da aktif bir Geçici lisans tarafından verilmiş. IsCapabilityGranted aynı soruyu yetenek bazında yanıtlar |
IsValidForDomain(host) | Ana bilgisayar kapsaması; V4 lisansları joker karakter *.* kullanır |
LicenseRejectionReason | Boş değil ⇒ açma bu mesajla engellenir |
DoconutLicenseInfo, yönetici panelleri için görüntü dostu anlık görüntüyü ortaya çıkarır: Owner, LicenseType, Domain, IsLicenseFileFound, IsVersionValid, IsTrial, IsExpired, Has* bayrakları, geçici lisans alanları ve RejectionMessage.
// GET /Features - UI'nizi SDK'nın kullandığı aynı gerçek kaynaktan feature-flag yapın
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);
}Sağlık kontrolü
Doconut, lisans durumunu raporlayan bir "doconut" sağlık kontrolü kaydeder. Classic ASP.NET'in kendi sağlık uç noktası yoktur, bu yüzden bir denetleyiciden ortaya çıkarın:
// GET /Health - Doconut bir "doconut" sağlık kontrolü kaydeder; bu kontrol lisans durumunu raporlar:
// Sağlıklı (geçerli), Bozulmuş (deneme veya lisans dosyası yok), Sağlıksız (reddedildi veya süresi doldu).
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");
}Bunu izleme sisteminize bağlayın ve süresi dolan bir abonelik, destek bileti yerine bir uyarı haline gelir. Kontrol, lisans reddedildiğinde Unhealthy rapor eder veya IsExpired doğru olduğunda; ücretli bir lisans için bu, abonelik tarihinin geçtiği ve ondan sonra yayınlanan bir paketin reddedileceği anlamına gelir — mevcut yapı temiz render etmeye devam eder. Durum değerleri için DoconutHost sayfasına bakın.
Sürüm yükseltmeleri
Bir lisans bir sürüm penceresini kapsar. NuGet paketini bu pencerenin daha yeni bir yapısına güncellemek, lisansı bu yapı için geçersiz kılar: IsVersionValid, false haline getirir ve açma engellenir bir LicenseException ile (neden License.RejectionMessage içinde). Bilinçli olarak hızlı başarısızlık, böylece eski veya lisanssız bir yapı dağıtımda yakalanır, üretim çıktısına sessizce filigran eklenmez. Aboneliği yenileyin, .lic'i wwwroot içinde değiştirin ve uygulama havuzunu yeniden başlatın, böylece DoconutHost.Initialize yeni lisansı yükler.
Bu sayfa yardımcı oldu mu?