مجوزدهی

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

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

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

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

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

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

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

قابلیت‌ها

Doconut عملکردهای اختیاری را با قابلیت محدود می‌کند. این شامل ویژگی‌های داخلی جستجو و حاشیه‌نویسی و افزونه‌های اختیاری مبدل، Dicom و Signer می‌شود که هر کدام توسط مجوز شما اعطا می‌شوند. نمایشگر پایه یک قابلیت نیست — بلکه پیش‌نیاز است که به صورت 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");

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

ارتقاء نسخه

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

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