مجوزدهی
قابلیتها، سطوح مجوز و سرویس مجوز
این صفحه مرجع زمان اجرا برای نحوهٔ شکلگیری رفتار Doconut توسط یک مجوز است: هر وضعیت مجوز چه چیزی را اجازه میدهد، چگونه قابلیتها اعطا میشوند، و چگونه میتوان همهٔ آن را از کد بررسی کرد. (برای بارگذاری یک مجوز، به شروع کار → تنظیم مجوز مراجعه کنید.)
وضعیتهای مجوز و عملکرد آنها
| وضعیت | سندها را باز میکند؟ | واترمارک | قابلیتها |
|---|---|---|---|
| مجوز کامل (پرداختشده) (این ساخت قبل از تاریخ اشتراک خود منتشر شد) | بله | هیچکدام | قابلیتهای خریداریشده (Has* flags) |
| مجوز موقت (Developer/NFR — مجوز ارزیابی، قبل از تاریخ انقضا) | بله | در نمایشگر پایه هیچکدام؛ خروجی افزونه دارای واترمارک است | همه — اعطای کلی (کانال ارزیابی) |
مجوز موقت منقضیشده (پس از تاریخ LicenseExpiry آن) | بله | واترمارک ارزیابی | هیچکدام اعطا نشد |
| بدون هیچ فایل مجوزی | بله | واترمارک ارزیابی | هیچکدام اعطا نشد |
| یافت شد اما رد شد (امضای نامعتبر، دستکاریشده، فهرستسیاه، یا ساختی که پس از تاریخ اشتراک مجوز منتشر شده است) | خیر — LicenseException در هر باز کردن | — | — |
یک مجوز پرداختشده که تاریخ اشتراک آن گذشته است، همچنان کار میکند — بدون واترمارک، با قابلیتهای خود — بر روی هر ساختی که قبل از آن تاریخ منتشر شده باشد. فقط ساختی که پس از آن منتشر شود رد میشود.
دو پیامد که ارزش درک دارند:
- یک مجوز گمشده، مجوز موقت نیست. بدون فایل مجوز، صفحات با واترمارک نمایش داده میشوند و هیچ قابلیتی (جستجو، حاشیهنویسی، افزونهها) فعال نیست. تجربهٔ کامل بدون واترمارک نیاز به یک مجوز موقت واقعی دارد (دریافت یک مورد).
- فقط یک مجوز رد شده باز کردن را مسدود میکند. یک مجوز موقت منقضیشده برنامه را با واترمارک ارزیابی ادامه میدهد، و یک مجوز پرداختشده پس از تاریخ اشتراک خود باز کردن تمیز را بر روی ساختهای تحت پوشش خود حفظ میکند؛ اما استقرار یک ساختی که پس از تاریخ اشتراک مجوز منتشر شده باشد رد میشود و بهسرعت شکست میخورد با یک
LicenseException، بنابراین آن را در زمان استقرار میگیرید — نه با ارسال بیصدا خروجی واترمارکی. آن استثنا (ازOpenDocumentAsync) دلیل را ازLicense.RejectionMessageحمل میکند.
قابلیتها
Doconut عملکردهای اختیاری را با قابلیت محدود میکند. این شامل ویژگیهای داخلی جستجو و حاشیهنویسی و افزونههای اختیاری مبدل، Dicom و Signer میشود که هر کدام توسط مجوز شما اعطا میشوند. نمایشگر پایه یک قابلیت نیست — بلکه پیشنیاز است که به صورت 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");آن را به سیستم نظارت خود متصل کنید و یک اشتراک منقضیشده بهجای یک تیکت پشتیبانی، یک هشدار میشود. این بررسی زمانی که مجوز رد شود یا IsExpired درست باشد، Unhealthy را گزارش میدهد؛ برای یک مجوز پرداختشده، این به معنای گذشت تاریخ اشتراک است و بستهای که پس از آن منتشر شود رد میشود — ساخت فعلی تمیز میماند.
ارتقاء نسخه
یک مجوز یک پنجرهٔ نسخه را پوشش میدهد. بهروزرسانی بسته NuGet به ساختی جدیدتر از آن پنجره، مجوز را برای این ساخت نامعتبر میکند: IsVersionValid به false تبدیل میشود و باز کردن مسدود میشود با یک LicenseException (دلیل در License.RejectionMessage است) — بهصورت عمدی بهسرعت شکست میخورد، بنابراین یک ساخت قدیمی یا بدون مجوز در زمان استقرار کشف میشود نه اینکه بهصورت بیصدا خروجی تولید را واترمارک کند. اشتراک را تمدید کنید، .lic را جایگزین کنید، و برنامه را دوباره راهاندازی کنید تا AddDoconut() مجوز جدید را بارگذاری کند.
آیا این صفحه مفید بود؟