مجوزدهی
قابلیتها، سطوح مجوز و سرویس مجوز
این صفحه مرجع زمان اجرا برای این است که چگونه یک مجوز رفتار Doconut را شکل میدهد: هر وضعیت مجوز چه چیزی را اجازه میدهد، چگونه قابلیتها اعطا میشوند و چگونه میتوان همهٔ آن را از کد بررسی کرد. (برای بارگذاری یک مجوز، به Getting Started → License Setup مراجعه کنید.)
وضعیتهای مجوز و عملکرد آنها
| وضعیت | اسناد را باز میکند؟ | علامت آب | قابلیتها |
|---|---|---|---|
| مجوز کامل (پرداختشده) (این ساخت قبل از تاریخ اشتراک آن منتشر شد) | بله | هیچ | پرچمهای خریداریشده (Has*) |
| مجوز موقت (توسعهدهنده/NFR — مجوز ارزیابی، قبل از تاریخ انقضا) | بله | در نمایشگر پایه هیچ؛ خروجی افزونه علامتآب دارد | همه — اعطای کلی (کانال ارزیابی) |
مجوز موقت منقضیشده (پس از تاریخ LicenseExpiry آن) | بله | علامت آب ارزیابی | هیچکدام اعطا نشده |
| هیچ فایل مجوزی وجود ندارد | بله | علامت آب ارزیابی | هیچکدام اعطا نشده |
| یافت شد اما رد شد (امضای نامعتبر، دستکاریشده، فهرستسیاه، یا ساختی که پس از تاریخ اشتراک مجوز منتشر شده) | خیر — LicenseException در هر باز کردن | — | — |
یک مجوز پرداختشده که تاریخ اشتراک آن گذشته است، همچنان کار میکند — بدون علامت آب، با قابلیتهای خود — در هر ساختی که قبل از آن تاریخ منتشر شده باشد. فقط ساختی که پس از آن منتشر شود رد میشود.
دو پیامد که ارزش درک دارند:
- یک مجوز گمشده، مجوز موقت نیست. بدون فایل مجوز، صفحات با علامت آب نمایش داده میشوند و هیچ قابلیت (جستجو، حاشیهنویسی، افزونهها) فعال نیست. تجربهٔ کامل بدون علامت آب نیاز به یک مجوز موقت واقعی دارد (دریافت کنید).
- فقط یک مجوز رد شده باز کردن را مسدود میکند. یک مجوز موقت منقضیشده برنامه را با علامت آب ارزیابی ادامه میدهد، و یک مجوز پرداختشده که تاریخ اشتراک آن گذشته است، در ساختهایی که پوشش میدهد بدون علامت آب رندر میشود؛ اما استقرار یک ساختی که پس از تاریخ اشتراک مجوز منتشر شده باشد رد میشود و بهسرعت شکست میخورد با یک
LicenseException، بنابراین آن را در زمان استقرار میگیرید — نه با ارسال خروجی علامتآبدار بهصورت خاموش. آن استثنا (ازOpenDocumentAsync) دلیل را ازLicense.RejectionMessageحمل میکند.
قابلیتها
Doconut عملکرد اختیاری را با قابلیت محدود میکند. این شامل ویژگیهای داخلی جستجو و حاشیهنویسی و افزونههای اختیاری مبدل، Dicom و Signer میشود که هر کدام توسط مجوز شما اعطا میشوند. نمایشگر پایه یک قابلیت نیست — بلکه پیشنیاز است که به صورت IsViewerLicensed ظاهر میشود:
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // مجوز non-TRIAL موجود و پوششدهنده نسخه این buildدروازهٔ تکتکهای که تمام خط لوله از آن استفاده میکند IsCapabilityGranted است:
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool searchGranted = lic.IsCapabilityGranted(LicenseCapability.Search);منطق آن، همانطور که در پیادهسازی آمده است: یک مجوز موقت فعال (غیرمنقضی) هر قابلیت را اعطا میکند — از جمله قابلیتهایی که هنوز پرچم خرید اختصاصی ندارند؛ یک مجوز خریداریشده واقعی دقیقاً پرچمهای Has* خود را اعطا میکند و برای هر چیز بدون نگاشت بهصورت پیشفرض رد میشود. (یک فایل نوع TRIAL قدیمی نیست یک حقالامتیاز — بهعنوان بدون مجوز در نظر گرفته میشود: علامتآبدار، هیچچیزی اعطا نمیشود.)
مجوزهای موقت
مجوزهای موقت (توسعهدهنده/NFR) با یک برچسب ExpiryNote علامتگذاری میشوند و تاریخ انقضای سختی دارند:
| عضو | معنی |
|---|---|
IsTemporary | یک برچسب ExpiryNote موجود است (تشخیص بر اساس وجود برچسب است — هرگز متن یادداشت را مطابقت ندهید، این پویا است) |
ExpiryNote | متن اطلاعاتی که در مجوز جاسازی شده است |
LicenseExpiry | تاریخ انقضای سخت (DateTime?) |
معنای انقضا بر حسب سطح متفاوت است: یک مجوز موقت در فقط تاریخ LicenseExpiry خود منقضی میشود (پنجرهٔ اشتراک آن نادیده گرفته میشود؛ یک مجوز موقت بدون تاریخ بهعنوان منقضی در نظر گرفته میشود، ایمن). تمام مجوزهای دیگر در تاریخ پنجرهٔ اشتراک/بهروزرسانی منقضی میشوند؛ برای یک مجوز پرداختشده، IsExpired فقط گزارش میدهد که این تاریخ گذشته است — ساختهای منتشر شده قبل از آن تمیز میمانند و قابلیتهای خود را حفظ میکنند.
مرجع IDoconutLicenseService
IDoconutLicenseService را تزریق کنید (فضای نام Doconut.Core.Interfaces؛ بهعنوان تکنمونه ثبت شده — مجوز یکبار در زمان راهاندازی تجزیه میشود):
| عضو | معنی |
|---|---|
License | Snapshot کامل 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() مجوز جدید را بارگذاری کند.
آیا این صفحه مفید بود؟