مجوزدهی

قابلیت‌ها، سطوح مجوز و سرویس مجوز

این صفحه مرجع زمان اجرا برای این است که چگونه یک مجوز رفتار Doconut را شکل می‌دهد: هر وضعیت مجوز چه چیزی را اجازه می‌دهد، چگونه قابلیت‌ها اعطا می‌شوند و چگونه می‌توان همهٔ آن را از کد بررسی کرد. (برای بارگذاری یک مجوز، به Getting Started → License Setup مراجعه کنید.)

وضعیت‌های مجوز و عملکرد آن‌ها

وضعیتاسناد را باز می‌کند؟علامت آبقابلیت‌ها
مجوز کامل (پرداخت‌شده) (این ساخت قبل از تاریخ اشتراک آن منتشر شد)بلههیچپرچم‌های خریداری‌شده (Has*)
مجوز موقت (توسعه‌دهنده/NFR — مجوز ارزیابی، قبل از تاریخ انقضا)بلهدر نمایشگر پایه هیچ؛ خروجی افزونه علامت‌آب داردهمه — اعطای کلی (کانال ارزیابی)
مجوز موقت منقضی‌شده (پس از تاریخ LicenseExpiry آن)بلهعلامت آب ارزیابیهیچ‌کدام اعطا نشده
هیچ فایل مجوزی وجود نداردبلهعلامت آب ارزیابیهیچ‌کدام اعطا نشده
یافت شد اما رد شد (امضای نامعتبر، دستکاری‌شده، فهرست‌سیاه، یا ساختی که پس از تاریخ اشتراک مجوز منتشر شده)خیر — LicenseException در هر باز کردن——

یک مجوز پرداخت‌شده که تاریخ اشتراک آن گذشته است، همچنان کار می‌کند — بدون علامت آب، با قابلیت‌های خود — در هر ساختی که قبل از آن تاریخ منتشر شده باشد. فقط ساختی که پس از آن منتشر شود رد می‌شود.

دو پیامد که ارزش درک دارند:

  • یک مجوز گمشده، مجوز موقت نیست. بدون فایل مجوز، صفحات با علامت آب نمایش داده می‌شوند و هیچ قابلیت (جستجو، حاشیه‌نویسی، افزونه‌ها) فعال نیست. تجربهٔ کامل بدون علامت آب نیاز به یک مجوز موقت واقعی دارد (دریافت کنید).
  • فقط یک مجوز رد شده باز کردن را مسدود می‌کند. یک مجوز موقت منقضی‌شده برنامه را با علامت آب ارزیابی ادامه می‌دهد، و یک مجوز پرداخت‌شده که تاریخ اشتراک آن گذشته است، در ساخت‌هایی که پوشش می‌دهد بدون علامت آب رندر می‌شود؛ اما استقرار یک ساختی که پس از تاریخ اشتراک مجوز منتشر شده باشد رد می‌شود و به‌سرعت شکست می‌خورد با یک LicenseException، بنابراین آن را در زمان استقرار می‌گیرید — نه با ارسال خروجی علامت‌آب‌دار به‌صورت خاموش. آن استثنا (از OpenDocumentAsync) دلیل را از License.RejectionMessage حمل می‌کند.

قابلیت‌ها

Doconut عملکرد اختیاری را با قابلیت محدود می‌کند. این شامل ویژگی‌های داخلی جستجو و حاشیه‌نویسی و افزونه‌های اختیاری مبدل، Dicom و Signer می‌شود که هر کدام توسط مجوز شما اعطا می‌شوند. نمایشگر پایه یک قابلیت نیست — بلکه پیش‌نیاز است که به صورت IsViewerLicensed ظاهر می‌شود:

csharp
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // مجوز non-TRIAL موجود و پوشش‌دهنده نسخه این build

دروازهٔ تک‌تکه‌ای که تمام خط لوله از آن استفاده می‌کند IsCapabilityGranted است:

csharp
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؛ به‌عنوان تک‌نمونه ثبت شده — مجوز یک‌بار در زمان راه‌اندازی تجزیه می‌شود):

عضومعنی
LicenseSnapshot کامل 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.

csharp
// 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 گزارش می‌دهد:

csharp
app.MapHealthChecks("/health");

آن را به سیستم مانیتورینگ خود متصل کنید و یک اشتراک منقضی‌شده به‌جای یک تیکت پشتیبانی تبدیل به هشدار می‌شود. این بررسی زمانی که مجوز رد شود یا IsExpired درست باشد، Unhealthy را گزارش می‌دهد؛ برای یک مجوز پرداخت‌شده، این به معنای عبور تاریخ اشتراک است و بسته‌ای که پس از آن منتشر شود رد می‌شود — ساخت فعلی بدون علامت آب رندر می‌شود.

ارتقاء نسخه‌ها

یک مجوز یک پنجرهٔ نسخه را پوشش می‌دهد. به‌روزرسانی بسته NuGet به ساختی جدیدتر از آن پنجره، مجوز را برای این ساخت نامعتبر می‌کند: IsVersionValid به false تبدیل می‌شود و باز کردن مسدود می‌شود با یک LicenseException (دلیل در License.RejectionMessage است) — به‌صورت عمدی به‌سرعت شکست می‌خورد، بنابراین یک ساخت منقضی یا بدون مجوز در زمان استقرار کشف می‌شود نه اینکه به‌صورت خاموش خروجی تولید را علامت‌آب کند. اشتراک را تمدید کنید، .lic را جایگزین کنید و برنامه را دوباره راه‌اندازی کنید تا AddDoconut() مجوز جدید را بارگذاری کند.

آیا این صفحه مفید بود؟