مجوزدهی
قابلیتها، سطوح مجوز و سرویس مجوز
این صفحه مرجع زمان اجرا برای نحوهٔ شکلگیری رفتار Doconut توسط یک مجوز است: هر وضعیت مجوز چه چیزی را اجازه میدهد، چگونه قابلیتها اعطا میشوند، و چگونه میتوان همهٔ آن را از کد بررسی کرد. (برای بارگذاری یک مجوز، به License Setup مراجعه کنید.)
وضعیتهای مجوز و عملکرد آنها
| وضعیت | آیا اسناد باز میشوند؟ | واترمارک | قابلیتها |
|---|---|---|---|
| مجوز کامل (پرداختشده) (این ساخت قبل از تاریخ اشتراک آن منتشر شد) | بله | هیچکدام | آنهایی که خریداری شدهاند (Has* flags) |
| مجوز موقت (Developer/NFR — مجوز ارزیابی، قبل از تاریخ انقضا) | بله | در نمایشگر پایه هیچکدام؛ خروجی افزونهها واترمارک دارد | همه — اعطای کلی (کانال ارزیابی) |
مجوز موقت منقضیشده (پس از تاریخ LicenseExpiry آن) | بله | واترمارک ارزیابی | هیچکدام اعطا نشده |
| بدون هیچ فایل مجوزی | بله | واترمارک ارزیابی | هیچکدام اعطا نشده |
| یافت شد اما رد شد (امضای نامعتبر، دستکاریشده، فهرستسیاه، یا ساختی که پس از تاریخ اشتراک مجوز منتشر شده) | نه — LicenseException در هر باز کردن | — | — |
یک مجوز پرداختشده که تاریخ اشتراک آن گذشته است، همچنان کار میکند — بدون واترمارک، با قابلیتهای خود — در هر ساختی که قبل از آن تاریخ منتشر شده باشد. فقط ساختی که پس از آن منتشر شود رد میشود.
دو پیامد که ارزش درک عمیق دارند:
- یک مجوز گمشده، مجوز موقت نیست. بدون فایل مجوز، صفحات با واترمارک نمایش داده میشوند و هیچ قابلیتی (جستجو، حاشیهنویسی، افزونهها) فعال نیست. تجربهٔ کامل بدون واترمارک نیاز به یک مجوز موقت واقعی دارد (دریافت یک مجوز).
- فقط یک مجوز رد شده باز کردن را مسدود میکند. یک مجوز موقت منقضیشده برنامه را با واترمارک ارزیابی ادامه میدهد، و یک مجوز پرداختشده پس از تاریخ اشتراک خود همچنان بدون واترمارک رندر میشود؛ اما استقرار یک ساختی که پس از تاریخ اشتراک مجوز منتشر شده باشد رد میشود و بهسرعت شکست میخورد با یک
LicenseException، بنابراین آن را در زمان استقرار میگیرید — نه با ارسال ساکت خروجی واترمارکشده. آن استثنا (ازOpenDocumentAsync) دلیل را ازLicense.RejectionMessageحمل میکند.
قابلیتها
Doconut عملکردهای اختیاری را با قابلیت کنترل میکند. این شامل ویژگیهای داخلی جستجو و حاشیهنویسی و افزونههای اختیاری مبدل، Dicom و Signer است که هر کدام توسط مجوز شما اعطا میشوند. نمایشگر پایه یک قابلیت نیست — پیشنیاز است که به صورت IsViewerLicensed نمایش داده میشود:
var lic = Doconut.DoconutHost.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // مجوز غیر‑آزمایشی موجود و پوششدهنده نسخه این ساختدروازهٔ تکتکهای که کل خط لوله استفاده میکند IsCapabilityGranted است:
var lic = Doconut.DoconutHost.Services.GetRequiredService<IDoconutLicenseService>();
bool searchGranted = lic.IsCapabilityGranted(LicenseCapability.Search);منطق آن، دقیقاً از پیادهسازی: یک مجوز موقت فعال (غیرمنقضی) هر قابلیت را اعطا میکند — از جمله قابلیتهایی که هنوز پرچم خرید اختصاصی ندارند؛ یک مجوز خریداریشده واقعی دقیقاً پرچمهای Has* خود را اعطا میکند و برای هر چیزی که نقشهبرداری نشده بهصورت پیشفرض رد میشود. (یک فایل نوع TRIAL قدیمی حقوقی نیست — به عنوان بدون مجوز در نظر گرفته میشود: واترمارک دارد، هیچچیزی اعطا نمیشود.)
مجوزهای موقت
مجوزهای موقت (Developer/NFR) با یک برچسب 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 - UI خود را با 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");
}آن را به سیستم نظارت خود متصل کنید و یک اشتراک منقضیشده به جای یک تیکت پشتیبانی به یک هشدار تبدیل میشود. بررسی زمانی که مجوز رد میشود یا IsExpired درست است، Unhealthy را گزارش میکند؛ برای یک مجوز پرداختشده، این به این معنی است که تاریخ اشتراک گذشته است و بستهای که پس از آن منتشر شود رد خواهد شد — ساخت فعلی بهصورت تمیز رندر میشود. برای مقادیر وضعیت، به میزبان Doconut مراجعه کنید.
ارتقاء نسخهها
یک مجوز یک پنجره نسخه را پوشش میدهد. بهروزرسانی بسته NuGet به ساختی جدیدتر از آن پنجره، مجوز را برای این ساخت نامعتبر میکند: IsVersionValid تبدیل به false میشود و باز کردن مسدود میشود با یک LicenseException (دلیل در License.RejectionMessage آمده است) — بهصورت عمدی سریعفشل میشود، بهطوری که یک ساخت کهنه یا بدون مجوز در زمان استقرار کشف میشود نه اینکه بهصورت خاموش خروجی تولید را واترمارک کند. اشتراک را تمدید کنید، .lic را در wwwroot جایگزین کنید، و استخر برنامه را بازچرخانی کنید تا DoconutHost.Initialize مجوز جدید را بارگذاری کند.
آیا این صفحه مفید بود؟