الترخيص

القدرات، مستويات الترخيص، وخدمة الترخيص

هذه الصفحة هي مرجع وقت التشغيل لكيفية تشكيل الترخيص لسلوك Doconut: ما تسمح به كل حالة ترخيص، كيف تُمنح القدرات، وكيفية فحص كل ذلك من الشيفرة. (لـ تحميل الترخيص، انظر إعداد الترخيص.)

حالات الترخيص وما تقوم به

الحالةيفتح المستندات؟علامة مائيةالقدرات
ترخيص كامل (مدفوع) (تم إصدار هذا البناء قبل تاريخ الاشتراك الخاص به)نعملا شيءالتي تم شراؤها (علامات Has*)
ترخيص مؤقت (مطور/غير تجاري — ترخيص التقييم، قبل تاريخ انتهاء صلاحيته)نعملا شيء على عارض الأساس؛ مخرجات الإضافة مائيةالكل — منح شامل (قمع التقييم)
ترخيص مؤقت منتهي (بعد تاريخ LicenseExpiry الخاص به)نعمعلامة مائية للتقييملا شيء ممنوح
لا ملف ترخيص على الإطلاقنعمعلامة مائية للتقييملا شيء ممنوح
تم العثور عليه لكن رُفض (توقيع غير صالح، تم العبث به، مدرج على القائمة السوداء، أو بناء تم إصداره بعد تاريخ اشتراك الترخيص)لا — LicenseException عند كل فتح——

ترخيص مدفوع تجاوز تاريخ اشتراكه يظل يعمل — نظيف، مع قدراته — على كل بناء تم إصداره قبل ذلك التاريخ. فقط بناء تم إصداره بعد ذلك يُرفض.

نتيجتان تستحقان الاستيعاب:

  • الترخيص المفقود ليس ترخيصًا مؤقتًا. بدون ملف ترخيص، تُظهر الصفحات علامة مائية ولا تُفعَّل أي قدرة (بحث، تعليقات، إضافات). التجربة الكاملة غير المائية تتطلب ترخيصًا مؤقتًا فعليًا (احصل على واحدة).
  • فقط الترخيص المرفوض يمنع الفتح. ترخيص مؤقت منتهي يبقي التطبيق يعمل مع علامة مائية للتقييم، وترخيص مدفوع تجاوز تاريخ اشتراكه يبقى يعرض نظيفًا على البنايات التي يغطيها؛ لكن نشر بناء تم إصداره بعد تاريخ اشتراك الترخيص يُرفض ويفشل سريعًا مع LicenseException، لذا تلتقطه عند النشر — لا عن طريق شحن مخرجات مائية صامتًا. ذلك الاستثناء (من OpenDocumentAsync) يحمل السبب من License.RejectionMessage.

القدرات

Doconut يحدّ الوظائف الاختيارية عبر القدرة. يغطي ذلك ميزات البحث والتعليق المدمجة والإضافات الاختيارية المحول، Dicom وSigner، كلٌّ يُمنح بحسب ترخيصك. عارض الأساس ليس قدرة — إنه المتطلب الأساسي، يُظهر كـ IsViewerLicensed:

csharp
var lic = Doconut.DoconutHost.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // ترخيص non-TRIAL موجود و يغطي نسخة هذا البناء

البوابة الوحيدة التي يستخدمها كامل خط الأنابيب هي IsCapabilityGranted:

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

منطقه، حرفيًا من التنفيذ: الترخيص المؤقت النشط (غير منتهي) يمنح كل قدرة — بما في ذلك القدرات التي لا تملك علامة شراء مخصصة بعد؛ الترخيص المدفوع الحقيقي يمنح بالضبط علامات Has* الخاصة به وهو الرفض الافتراضي لأي شيء غير مُطابق. (ملف نوع TRIAL التراثي ليس استحقاقًا — يُعامل كغير مرخص: مائي، لا شيء ممنوح.)

التراخيص المؤقتة

التراخيص المؤقتة (مطور/غير تجاري) تُ标ّ بـ ExpiryNote وتحمل تاريخ انتهاء صلب:

العضوالمعنى
IsTemporaryعلامة ExpiryNote موجودة (الكشف يتم بوجود العلامة — لا يطابق نص الملاحظة أبداً، فهي ديناميكية)
ExpiryNoteنص معلوماتي مدمج في الترخيص
LicenseExpiryتاريخ الانتهاء الصارم (DateTime?)

تختلف دلالات الانتهاء بحسب المستوى: الترخيص المؤقت ينتهي في تاريخ LicenseExpiry فقط (يُهمل نافذة الاشتراك؛ الترخيص المؤقت الذي يفتقد التاريخ يُعامل كمنتهي، آمن). كل ترخيص آخر ينتهي في تاريخ نافذة الاشتراك/التحديث؛ بالنسبة لترخيص مدفوع، IsExpired يُظهر فقط أن هذا التاريخ قد مر — البنايات الصادرة قبل ذلك تظل نظيفة وتحتفظ بقدراتها.

مرجع IDoconutLicenseService

حل IDoconutLicenseService (المساحة الاسمية Doconut.Core.Interfaces) من DoconutHost.Services. إنها كائن واحد — يتم تحليل الترخيص مرة واحدة، في DoconutHost.Initialize:

العضوالمعنى
Licenseلقطة كاملة لـ DoconutLicenseInfo (أدناه)
IsTrialملف نوع TRIAL قديم (يُعامل كغير مرخص — ليس استحقاقًا)
IsTemporary / ExpiryNote / LicenseExpiryعلامات الترخيص المؤقت
IsExpiredمنتهي وفقًا لقواعد المستوى أعلاه
IsVersionValidهذا البناء يقع ضمن نافذة دعم الترخيص
IsViewerLicensedتم العثور على ملف غير TRIAL و تم تغطية الإصدار — شرط أساسي
IsCapabilityGranted(cap)بوابة القدرة الوحيدة
HasSearch HasAnnotation HasEditor HasConverter HasDicom HasDocumentTools HasSigner HasRedactor HasComparer HasForms HasProtector HasCompressorعلم واحد لكل قدرة: تم شراؤه بواسطة ترخيص يغطي هذا البناء، أو مُمنح بواسطة ترخيص مؤقت نشط. IsCapabilityGranted يجيب على نفس السؤال بحسب القدرة
IsValidForDomain(host)تغطية المضيف؛ تراخيص V4 تستخدم البدل *.*
LicenseRejectionReasonغير فارغ ⇒ يتم حظر الفتح بهذه الرسالة

DoconutLicenseInfo يعرض اللقطة الصديقة للعرض للوحة الإدارة: Owner، LicenseType، Domain، IsLicenseFileFound، IsVersionValid، IsTrial، IsExpired، أعلام Has*، حقول الترخيص المؤقت، وRejectionMessage.

csharp
// GET /Features - feature-flag واجهة المستخدم الخاصة بك من نفس مصدر الحقيقة الذي يستخدمه 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);
}

فحص الصحة

Doconut يسجل فحص صحة "doconut" الذي يبلغ عن حالة الترخيص. لا يحتوي Classic ASP.NET على نقطة فحص صحة خاصة به، لذا قم بالكشف عنها من خلال وحدة تحكم:

csharp
// GET /Health - Doconut يسجل فحص صحة "doconut" الذي يُبلغ عن حالة الترخيص:
// صحي (صالح), متدهور (تجريبي أو لا يوجد ملف ترخيص), غير صحي (مرفوض أو منتهي الصلاحية).
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");
}

اربطه بمراقبتك وستصبح الاشتراك القريب الانتهاء تنبيهًا بدلاً من تذكرة دعم. الفحص يبلغ عن Unhealthy عندما يُرفض الترخيص أو يكون IsExpired صحيحًا؛ بالنسبة لترخيص مدفوع، يعني ذلك أن تاريخ الاشتراك قد مر وحزمة صُدرت بعده سيتم رفضها — يبقى البناء الحالي يعرض نظيفًا. راجع DoconutHost للحصول على قيم الحالة.

ترقيات الإصدار

يغطي الترخيص نافذة الإصدار. تحديث حزمة NuGet إلى بناء أحدث من تلك النافذة يجعل الترخيص غير صالح لهذا البناء: يتحول IsVersionValid إلى false ويتم حظر الفتح باستخدام LicenseException (السبب في License.RejectionMessage) — فشل سريع متعمد، بحيث يتم اكتشاف بناء قديم أو غير مرخص عند النشر بدلاً من وضع علامة مائية صامتة على مخرجات الإنتاج. جدد الاشتراك، استبدل .lic في wwwroot، وأعد تدوير مجموعة التطبيقات حتى يحمل DoconutHost.Initialize الترخيص الجديد.

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