إعداد الترخيص

المكان الذي يبحث فيه Doconut عن ملف الترخيص الخاص بك تحت IIS

بدون ترخيص، لا يزال Doconut يعرض المستندات — كل صفحة تحمل فقط علامة مائية للتقييم. تغطي هذه الصفحة الطرق الأربع لتزويد الترخيص في Global.asax، وأين يبحث Doconut عندما لا تزوده بأي شيء، وما يحدث عندما يكون ترخيص المكوّن الإضافي مفقودًا.

أربع طرق لتزويد الترخيص

هناك ثلاث مصادر صريحة على DoconutOptions — مسار ملف، دفق، أو محتوى خام — بالإضافة إلى الاكتشاف التلقائي عندما لا يتم تعيين أي منها. تُقرأ جميعها مرة واحدة، في DoconutHost.Initialize. عندما يتم تعيين أكثر من واحد، تكون الأولوية كما يلي بالضبط:

LicenseStream يتفوق على LicenseContent يتفوق على LicensePath يتفوق على الاكتشاف التلقائي.

عبر المسار

قدّم LicensePath مسارًا كاملاً. يتم حل المسار النسبي بالنسبة إلى الدليل الحالي للعملية، وتحت IIS يكون ذلك مجلد عملية العامل نفسها، وليس موقعك. HostingEnvironment.MapPath يحول مسارًا نسبيًا للموقع إلى مسار كامل:

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

إذا لم يكن الملف موجودًا، لا يرمي Doconut استثناء ولا يتراجع إلى الاكتشاف التلقائي: لا يحمل أي ترخيص، ويضيف علامة مائية للعارض. تُقرأ ملفات الترخيص الخاصة بكل مكوّن إضافي في نفس المجلد (Doconut.Viewer.<Capability>.lic) معها، لذا يعمل LicensePath و AddPlugin<...>() معًا عندما تكون تراخيص المكوّنات الإضافية بجوار الترخيص الأساسي.

عبر الدفق

LicenseStream تُقرأ مرة واحدة، عند بدء التشغيل — مفيد عندما يأتي الترخيص من مورد مدمج أو مخزن سري بدلاً من ملف على القرص.

csharp
// الأولوية: LicenseStream > LicenseContent > LicensePath > البحث التلقائي.
Doconut.DoconutHost.Initialize(options =>
{
    options.LicenseStream = licenseStream;
});

عبر المحتوى

LicenseContent يأخذ نص الترخيص نفسه — من متغيّر بيئي، قاعدة بيانات، أو مخزن سري — لذا لا يلزم نشر ملف ترخيص مع الموقع.

csharp
// License XML من قاعدة بيانات أو متغيّر بيئي أو مخزن سري -
// لا ملف على القرص. لا يتفوق عليه سوى LicenseStream.
Doconut.DoconutHost.Initialize(options =>
{
    options.LicenseContent = Environment.GetEnvironmentVariable("DOCONUT_LICENSE") ?? "";
});

الاكتشاف التلقائي

لا تعين أيًا من الثلاثة، ويبحث Doconut عن الترخيص بنفسه:

csharp
// لا تقم بأي إعداد، و Doconut يبحث عن الترخيص نفسه، بهذا الترتيب:
//   1. {CurrentDirectory}\wwwroot
//   2. {AppContext.BaseDirectory}\wwwroot   (تحت IIS: مجلد جذر الموقع)
// يبحث عن Doconut.lic أولاً؛ إذا كان مفقودًا، Doconut.Viewer.lic بالإضافة إلى أي
// ملفات Doconut.Viewer.<Capability>.lic لكل مكوّن إضافي.
Doconut.DoconutHost.Initialize();

المجلدان، بالترتيب، والملفات التي يتم البحث عنها:

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

أسماء الملفات، بالترتيب (كل واحدة تُبحث عنها في المجلد 1، ثم المجلد 2):

تحت IIS و IIS Express، AppContext.BaseDirectory هو مجلد جذر الموقع — الذي يحتوي على Web.config — وليس مجلد bin الخاص به. لذا يجب أن يكون الترخيص في wwwroot تحت جذر الموقع:

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

في المشروع، احتفظ بـ wwwroot\*.lic بجوار Web.config وانشر المجلد مع الموقع. لا تحتاج أي خطوة بناء لنسخه إلى أي مكان. أي .lic في مكان آخر — في bin\، بجوار Web.config، أو في مجلد فرعي لـ wwwroot — لا يُقرأ أبدًا.

احتفظ بملفات .lic خارج التحكم في المصدر. انشرها جنبًا إلى جنب مع الموقع، أو زوّد الترخيص عبر LicenseContent أو LicenseStream من مخزن الأسرار الخاص بك.

ماذا يحدث بدون ترخيص

عدم وجود ترخيص لا يسبب استثناء. DoconutHost.Initialize ينجح، يبدأ الموقع، ويعمل العارض، لكن كل صفحة تحمل علامة مائية للتقييم ولا تُمنح أي قدرة اختيارية.

ملف الترخيص الموجود لكن مرفوض يختلف. توقيع غير صالح، أو تعديل، أو بناء خارج نافذة إصدار الترخيص يجعل OpenDocumentAsync يرمي LicenseException مع السبب. الترخيص المؤقت المنتهي يواصل العمل في وضع العلامة المائية. الترخيص المدفوع الذي تجاوز تاريخ الاشتراك يظل يعمل، نظيفًا ومع قدراته، على كل بناء تم إصداره قبل ذلك التاريخ.

الإضافات تحتاج ترخيصها عند بدء التشغيل

تسجيل إضافة لا يمنحها أي ترخيص القدرة يتوقف التطبيق عند بدء التشغيل. DoconutHost.Initialize يرمي في Application_Start:

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، لا ترى تلك الرسالة في المتصفح. كل طلب إلى الموقع يرد بـ 500 فارغ — لا صفحة خطأ، لا تتبع للمكدس، لا شيء في سجل IIS. يتم تسجيل الاستثناء فقط في سجل أحداث Windows (سجل التطبيق، المصدر ASP.NET). إذا توقف الموقع بالكامل عن الاستجابة مباشرة بعد إضافة سطر AddPlugin، فتحقق من ملفات الترخيص في wwwroot قبل الشيفرة: يجب أن يكون Doconut.Viewer.<Capability>.lic الخاص بالإضافة بجوار Doconut.Viewer.lic، وبدون الترخيص الأساسي لا تُقرأ ملفات الإضافة مطلقًا.

تحقق من الترخيص المحمَّل

IDoconutLicenseService هو نفس مصدر الحقيقة الذي يستخدمه SDK. حلّها من DoconutHost.Services لكشف نقطة تشخيص موثقة أو تشغيل أعلام الميزات — لا تُرجع محتوى الترخيص أبداً:

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);
}

يُقرأ الترخيص مرة واحدة، في DoconutHost.Initialize. بعد استبدال ملف الترخيص، أعد تدوير مجموعة التطبيقات (أو عدل Web.config) حتى Application_Start يعمل مرة أخرى.

استكشاف الأخطاء وإصلاحها

العَرَضالسبب المحتملالتحقق
العارض يعمل لكن كل صفحة تحمل علامة مائيةلم يُعثر على ترخيصهل .lic موجود في <site root>\wwwroot؟ استدعِ نقطة الحالة أعلاه
كل طلب يرد بـ 500 فارغ مباشرة بعد إضافة إضافةإضافة مسجلة لا تملك ترخيصًا يمنحها القدرةسجل أحداث Windows، المصدر ASP.NET؛ .lic الخاص بالإضافة بجوار Doconut.Viewer.lic
LicensePath يعمل على جهازك لكن ليس على الخادممسار نسبي يُحلّ ضد مجلد عملية العاملابنِه باستخدام HostingEnvironment.MapPath("~/wwwroot/...")
ملف .lic المستبدل لا يؤثرتم قراءة الترخيص عندما بدأ التطبيقأعد تدوير مجموعة التطبيقات
OpenDocumentAsync يرمي LicenseExceptionتم العثور على الترخيص لكنه رُفضاقرأ رسالة الاستثناء؛ لا تُظهرها للعملاء غير الموثوق بهم

الخطوات التالية

هل كانت هذه الصفحة مفيدة؟