الترخيص
القدرات، مستويات الترخيص، وخدمة الترخيص
هذه الصفحة هي مرجع وقت التشغيل لكيفية تشكيل الترخيص لسلوك Doconut: ما تسمح به كل حالة ترخيص، كيف تُمنح القدرات، وكيفية فحص كل ذلك من الشيفرة. (لـ تحميل الترخيص، انظر إعداد الترخيص.)
حالات الترخيص وما تقوم به
| الحالة | يفتح المستندات؟ | علامة مائية | القدرات |
|---|---|---|---|
| ترخيص كامل (مدفوع) (تم إصدار هذا البناء قبل تاريخ الاشتراك الخاص به) | نعم | لا شيء | التي تم شراؤها (علامات Has*) |
| ترخيص مؤقت (مطور/غير تجاري — ترخيص التقييم، قبل تاريخ انتهاء صلاحيته) | نعم | لا شيء على عارض الأساس؛ مخرجات الإضافة مائية | الكل — منح شامل (قمع التقييم) |
ترخيص مؤقت منتهي (بعد تاريخ LicenseExpiry الخاص به) | نعم | علامة مائية للتقييم | لا شيء ممنوح |
| لا ملف ترخيص على الإطلاق | نعم | علامة مائية للتقييم | لا شيء ممنوح |
| تم العثور عليه لكن رُفض (توقيع غير صالح، تم العبث به، مدرج على القائمة السوداء، أو بناء تم إصداره بعد تاريخ اشتراك الترخيص) | لا — LicenseException عند كل فتح | — | — |
ترخيص مدفوع تجاوز تاريخ اشتراكه يظل يعمل — نظيف، مع قدراته — على كل بناء تم إصداره قبل ذلك التاريخ. فقط بناء تم إصداره بعد ذلك يُرفض.
نتيجتان تستحقان الاستيعاب:
- الترخيص المفقود ليس ترخيصًا مؤقتًا. بدون ملف ترخيص، تُظهر الصفحات علامة مائية ولا تُفعَّل أي قدرة (بحث، تعليقات، إضافات). التجربة الكاملة غير المائية تتطلب ترخيصًا مؤقتًا فعليًا (احصل على واحدة).
- فقط الترخيص المرفوض يمنع الفتح. ترخيص مؤقت منتهي يبقي التطبيق يعمل مع علامة مائية للتقييم، وترخيص مدفوع تجاوز تاريخ اشتراكه يبقى يعرض نظيفًا على البنايات التي يغطيها؛ لكن نشر بناء تم إصداره بعد تاريخ اشتراك الترخيص يُرفض ويفشل سريعًا مع
LicenseException، لذا تلتقطه عند النشر — لا عن طريق شحن مخرجات مائية صامتًا. ذلك الاستثناء (منOpenDocumentAsync) يحمل السبب منLicense.RejectionMessage.
القدرات
Doconut يحدّ الوظائف الاختيارية عبر القدرة. يغطي ذلك ميزات البحث والتعليق المدمجة والإضافات الاختيارية المحول، Dicom وSigner، كلٌّ يُمنح بحسب ترخيصك. عارض الأساس ليس قدرة — إنه المتطلب الأساسي، يُظهر كـ IsViewerLicensed:
var lic = Doconut.DoconutHost.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // ترخيص non-TRIAL موجود و يغطي نسخة هذا البناءالبوابة الوحيدة التي يستخدمها كامل خط الأنابيب هي IsCapabilityGranted:
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.
// 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 على نقطة فحص صحة خاصة به، لذا قم بالكشف عنها من خلال وحدة تحكم:
// 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 الترخيص الجديد.
هل كانت هذه الصفحة مفيدة؟