مجوزدهی
قابلیتها، سطوح مجوز، و سرویس مجوز
این صفحه مرجع زمان اجرا برای نحوهٔ شکلگیری رفتار Doconut توسط یک مجوز است: آنچه هر وضعیت مجوز اجازه میدهد، چگونه قابلیتها اعطا میشوند، و چگونه میتوان همهٔ اینها را از کد بررسی کرد. (برای بارگذاری یک مجوز، به «شروع کار → تنظیم مجوز» مراجعه کنید.)
وضعیتهای مجوز و عملکرد آنها
| وضعیت | اسناد را باز میکند؟ | واترمارک | قابلیتها |
|---|---|---|---|
| مجوز کامل (پرداختشده) (این ساخت قبل از تاریخ اشتراک خود منتشر شد) | بله | هیچ | پرچمهای خریداری شده (Has*) |
| مجوز موقت (توسعهدهنده/NFR — مجوز ارزیابی، قبل از تاریخ انقضا) | بله | در نمایشگر پایه هیچیک؛ خروجی افزونه دارای واترمارک است | All — اعطای کلی (کانال ارزیابی) |
مجوز موقت منقضیشده (پس از تاریخ LicenseExpiry) | بله | واترمارک ارزیابی | هیچیک اعطا نشده |
| بدون فایل مجوز | بله | واترمارک ارزیابی | هیچیک اعطا نشده |
| یافت شد اما رد شد (امضای نامعتبر، دستکاری شده، فهرست سیاه، یا ساختی که پس از تاریخ اشتراک مجوز منتشر شده است) | No — LicenseException در هر باز کردن | — | — |
یک مجوز پرداختشده که تاریخ اشتراک آن گذشته است، همچنان کار میکند — بدون واترمارک، با قابلیتهای خود — بر روی هر ساختی که قبل از آن تاریخ منتشر شده باشد. تنها ساختی که پس از آن منتشر شود، رد میشود.
دو پیامد که ارزش درک دارند:
- یک مجوز مفقود یک مجوز موقت نیست. بدون فایل مجوز، صفحات با واترمارک نمایش داده میشوند و هیچ قابلیتی (جستجو، حاشیهنویسی، افزونهها) فعال نیست. تجربهٔ کامل بدون واترمارک نیاز به یک مجوز موقت واقعی دارد (دریافت یک مورد).
- فقط یک مجوز رد شده باز کردن را مسدود میکند. یک مجوز موقت منقضیشده برنامه را با واترمارک ارزیابی ادامه میدهد، و یک مجوز پرداختشده پس از تاریخ اشتراک خود بهصورت تمیز رندر میشود بر روی ساختهایی که پوشش میدهد؛ اما استقرار یک ساختی که پس از تاریخ اشتراک مجوز منتشر شده باشد، رد میشود و بهسرعت شکست میخورد با یک
LicenseException، بنابراین آن را در زمان استقرار میگیرید — نه با ارسال بیصدا خروجی واترمارکشده. آن استثنا (ازOpenDocumentAsync) دلیل را ازLicense.RejectionMessageحمل میکند.
قابلیتها
Doconut عملکردهای اختیاری را با قابلیت محدود میکند. این شامل ویژگیهای داخلی جستجو و حاشیهنویسی و افزونههای اختیاری مبدل، دیکام و امضا کننده است که هر کدام توسط مجوز شما اعطا میشوند. نمایشگر پایه یک قابلیت نیست — بلکه پیشنیاز است که بهصورت IsViewerLicensed ظاهر میشود:
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // مجوز non-TRIAL موجود و پوششدهنده نسخه این ساختدروازهٔ تککه کل خط لوله استفاده میکند IsCapabilityGranted:
var lic = app.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؛ بهعنوان تکنمونه ثبت شده — مجوز یکبار در زمان شروع تجزیه میشود):
| عضو | معنی |
|---|---|
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.
// Feature-flag رابط کاربری خود را از همان منبع حقیقتی که SDK استفاده میکند
app.MapGet("/api/features", (IDoconutLicenseService lic) => Results.Ok(new
{
viewer = lic.IsViewerLicensed || lic.IsTemporary,
search = lic.IsCapabilityGranted(LicenseCapability.Search),
annotation = lic.IsCapabilityGranted(LicenseCapability.Annotation),
conversion = lic.HasConverter,
dicom = lic.HasDicom,
}));بررسی سلامت
AddDoconut() یک بررسی سلامت "doconut" را ثبت میکند که وضعیت مجوز/انقضا را از طریق مکانیزم استاندارد ASP.NET Core گزارش میدهد:
app.MapHealthChecks("/health");آن را به سامانهٔ نظارت خود متصل کنید و یک اشتراک در حال انقضا بهجای یک تیکت پشتیبانی تبدیل به هشدار میشود. بررسی گزارش میدهد Unhealthy وقتی مجوز رد میشود یا IsExpired درست است؛ برای یک مجوز پرداختشده، این به این معناست که تاریخ اشتراک گذشته است و بستهای که پس از آن منتشر شود رد خواهد شد — ساخت فعلی بهصورت تمیز رندر میشود.
ارتقاء نسخهها
یک مجوز یک پنجرهٔ نسخه را پوشش میدهد. بهروزرسانی بسته NuGet به ساختی جدیدتر از آن پنجره باعث میشود مجوز برای این ساخت نامعتبر شود: IsVersionValid به false تبدیل میشود و باز کردن مسدود میشود با یک LicenseException (دلیل در License.RejectionMessage است) — بهصورت عمدی بهسرعت شکست میخورد، بنابراین یک ساخت کهنه یا بدون مجوز در زمان استقرار کشف میشود نه اینکه بهصورت بیصدا خروجی تولید را واترمارک کند. اشتراک را تمدید کنید، .lic را جایگزین کنید، و برنامه را دوباره راهاندازی کنید تا AddDoconut() مجوز جدید را بارگذاری کند.
آیا این صفحه مفید بود؟