مجوزدهی

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

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

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

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

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

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

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

قابلیت‌ها

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

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

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

csharp
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.

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");

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

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

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

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