Lisans Kurulumu

IIS altında Doconut'un lisans dosyanızı nerede aradığı

Bir lisans olmadan, Doconut hâlâ belgeleri render eder — her sayfa sadece bir değerlendirme filigranı taşır. Bu sayfa, Global.asax içinde bir lisans sağlamanın dört yolunu, lisans sağlamadığınızda Doconut'un nerelere baktığını ve bir eklentinin lisansı eksik olduğunda ne olduğunu kapsar.

Lisans sağlamanın dört yolu

DoconutOptions üzerinde üç açık kaynak vardır — bir dosya yolu, bir akış veya ham içerik — ayrıca hiçbiri ayarlanmamışsa otomatik keşif. Hepsi bir kez, DoconutHost.Initialize içinde okunur. Birden fazla ayarlandığında öncelik tam olarak şöyledir:

LicenseStream, LicenseContent'i, LicensePath'yı, otomatik keşfi geçer.

Yol ile

LicensePath'a tam bir yol verin. Göreceli bir yol, işlemin geçerli dizinine göre çözülür ve IIS altında bu, çalışan işlemin kendi klasörüdür, siteniz değil. HostingEnvironment.MapPath, siteye göreli bir yolu tam bir yola dönüştürür:

csharp
Doconut.DoconutHost.Initialize(options =>
{
    options.LicensePath = HostingEnvironment.MapPath("~/wwwroot/Doconut.Viewer.lic");
});

Dosya mevcut değilse, Doconut bir hata atmaz ve otomatik keşfe geri dönmez: hiçbir lisans yüklemez ve görüntüleyici filigran ekler. Aynı klasördeki eklenti başına lisans dosyaları (Doconut.Viewer.<Capability>.lic) onunla birlikte okunur, böylece LicensePath ve AddPlugin<...>(), eklenti lisansları temel lisansın yanında bulunduğunda birlikte çalışır.

Akış ile

LicenseStream bir kez, başlangıçta okunur — lisansın bir dosyadan değil, gömülü bir kaynaktan veya gizli bir depodan gelmesi durumunda faydalıdır.

csharp
// Öncelik: LicenseStream > LicenseContent > LicensePath > otomatik arama.
Doconut.DoconutHost.Initialize(options =>
{
    options.LicenseStream = licenseStream;
});

İçerik ile

LicenseContent lisans metnini doğrudan alır — bir ortam değişkeninden, bir veritabanından veya gizli bir depodan — böylece siteyle birlikte bir lisans dosyası dağıtmak gerekmez.

csharp
// License XML bir veritabanından, bir ortam değişkeninden veya bir gizli depodan -
// diskte dosya yok. Yalnızca LicenseStream tarafından geçilir.
Doconut.DoconutHost.Initialize(options =>
{
    options.LicenseContent = Environment.GetEnvironmentVariable("DOCONUT_LICENSE") ?? "";
});

Otomatik keşif

Üçünden hiçbirini ayarlamazsanız, Doconut lisansı kendisi arar:

csharp
// Hiçbir şey yapılandırma ve Doconut lisansı kendisi arar, şu sırayla:
//   1. {CurrentDirectory}\wwwroot
//   2. {AppContext.BaseDirectory}\wwwroot   (IIS altında: sitenin kök klasörü)
// İlk olarak Doconut.lic dosyasını arar; eğer bu eksikse, Doconut.Viewer.lic ve herhangi bir
// her eklenti için Doconut.Viewer.<Capability>.lic dosyaları.
Doconut.DoconutHost.Initialize();

İki klasör, sırasıyla, ve aranan dosyalar:

text
1. {CurrentDirectory}\wwwroot
2. {AppContext.BaseDirectory}\wwwroot

Filenames, in order (each one looked for in folder 1, then folder 2):
  Doconut.lic                        — legacy all-in-one license; if found, nothing else is read
  Doconut.Viewer.lic                 — base viewer license
  Doconut.Viewer.<Capability>.lic    — per-plugin licenses, read only when Doconut.Viewer.lic was found

IIS ve IIS Express altında, AppContext.BaseDirectory sitenin kök klasörüdür — Web.config'ı tutan klasör — bin klasörü değil. Bu yüzden lisans, site kökünün altında wwwroot içinde bulunmalıdır:

text
MySite\
  Web.config
  Global.asax
  bin\
  wwwroot\
    Doconut.Viewer.lic
    Doconut.Viewer.Converter.lic

Projede, wwwroot\*.lic'ı Web.config'ın yanında tutun ve klasörü siteyle birlikte dağıtın. Hiçbir derleme adımı onu bir yere kopyalamak zorunda değildir. Başka bir yerde bir .lic — bin\ içinde, Web.config'ın yanında veya wwwroot'ın bir alt klasöründe — asla okunmaz.

.lic dosyalarını kaynak kontrolünden uzak tutun. Bunları siteyle birlikte dağıtın, ya da lisansı gizli deponuzdan LicenseContent veya LicenseStream aracılığıyla sağlayın.

Lisans olmadan ne olur

Eksik bir lisans bir hata oluşturmaz. DoconutHost.Initialize başarılı olur, site başlar ve görüntüleyici çalışır, ancak her sayfa bir değerlendirme filigranı taşır ve hiçbir isteğe bağlı özellik verilmez.

Bulunan ancak reddedilen bir lisans dosyası farklıdır. Geçersiz bir imza, müdahale veya lisansın sürüm penceresinin dışındaki bir derleme, OpenDocumentAsync'nin LicenseException'yi sebebiyle fırlatmasına neden olur. Süresi dolmuş Geçici lisans filigranlı modda devam eder. Abonelik tarihi geçmiş bir ücretli lisans, o tarihten önce yayınlanan her derlemede temiz ve yetenekleriyle çalışmaya devam eder.

Eklentilerin başlangıçta lisansına ihtiyacı var

Hiçbir lisansın yetki vermediği bir eklentiyi kaydetmek, uygulamayı başlangıçta durdurur. DoconutHost.Initialize, Application_Start içinde fırlatır:

text
InvalidOperationException: The Converter plugin is registered via AddPlugin but no active
license grants Converter. Remove the AddPlugin<...>() call or install a license (or
trial/demo) that includes Converter.

System.Web altında, bu mesajı tarayıcıda görmezsiniz. Siteye yapılan her istek boş bir 500 ile yanıt verir — hata sayfası yok, yığın izleme yok, IIS günlüğünde hiçbir şey yok. İstisna yalnızca Windows olay günlüğünde (Uygulama günlüğü, kaynak ASP.NET) kaydedilir. Tüm site, bir AddPlugin satırı ekledikten hemen sonra yanıt vermeyi durdurursa, koddan önce wwwroot içindeki lisans dosyalarını kontrol edin: eklentinin Doconut.Viewer.<Capability>.lic'ı Doconut.Viewer.lic'ın yanına yerleştirilmeli ve temel lisans olmadan eklenti dosyaları hiç okunmaz.

Yüklenen lisansı doğrula

IDoconutLicenseService, SDK'nin kullandığı aynı gerçek kaynaktır. Lisans içeriğini asla döndürmeden, kimliği doğrulanmış bir tanı uç noktasını ortaya çıkarmak veya özellik bayraklarını yönlendirmek için DoconutHost.Services'den çözün:

csharp
// GET /License/Status
public ActionResult Status()
{
    var license = Doconut.DoconutHost.Services.GetRequiredService<IDoconutLicenseService>();

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

Lisans, DoconutHost.Initialize içinde bir kez okunur. Bir lisans dosyasını değiştirdikten sonra, uygulama havuzunu yeniden başlatın (veya Web.config'a dokunun) böylece Application_Start tekrar çalışır.

Sorun Giderme

SemptomMuhtemel nedenKontrol
Görüntüleyici çalışıyor ancak her sayfa filigranlıLisans bulunamadı.lic, <site root>\wwwroot içinde mi? Yukarıdaki durum uç noktasını çağırın
Eklenti ekledikten hemen sonra her istek boş bir 500 ile yanıt verirKayıtlı bir eklentinin ona lisans vermesi yokWindows olay günlüğü, kaynak ASP.NET; eklentinin .lic'ı Doconut.Viewer.lic'ın yanında
LicensePath, makinenizde çalışıyor ancak sunucuda çalışmıyorİşçi süreç klasörüne göre çözülen bir göreli yolBunu HostingEnvironment.MapPath("~/wwwroot/...") ile derleyin
Değiştirilen .lic dosyasının etkisi yokLisans, uygulama başlatıldığında okunduUygulama havuzunu yeniden başlatın
OpenDocumentAsync, LicenseException fırlatırLisans bulundu ancak reddedildiİstisna mesajını okuyun; güvenilmeyen istemcilere göstermeyin

Sonraki adımlar

  • Lisanslama — yetenekler ve çalışma zamanında nasıl kontrol edileceği.
  • Sorun Giderme — filigranlar, başlangıç hataları ve diğer semptomlar.

Bu sayfa yardımcı oldu mu?