مجوزدهی

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

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

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

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

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

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

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

قابلیت‌ها

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

csharp
var lic = Doconut.DoconutHost.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // مجوز غیر‑آزمایشی موجود و پوشش‌دهنده نسخه این ساخت

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

csharp
var lic = Doconut.DoconutHost.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) از DoconutHost.Services حل کنید. این یک تک‌نمونه است — مجوز یک بار، در DoconutHost.Initialize تجزیه می‌شود:

عضومعنی
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
// GET /Features - UI خود را با feature-flag از همان منبع حقیقتی که SDK استفاده می‌کند
public ActionResult Index()
{
    var lic = Doconut.DoconutHost.Services.GetRequiredService<IDoconutLicenseService>();

    return Json(new
    {
        viewer     = lic.IsViewerLicensed || lic.IsTemporary,
        search     = lic.IsCapabilityGranted(LicenseCapability.Search),
        annotation = lic.IsCapabilityGranted(LicenseCapability.Annotation),
        conversion = lic.HasConverter,
        dicom      = lic.HasDicom,
    }, JsonRequestBehavior.AllowGet);
}

بررسی سلامت

Doconut یک بررسی سلامت "doconut" ثبت می‌کند که وضعیت مجوز را گزارش می‌دهد. Classic ASP.NET نقطه پایانی سلامت خود را ندارد، بنابراین آن را از یک کنترلر افشا کنید:

csharp
// GET /Health - Doconut یک بررسی سلامت "doconut" را ثبت می‌کند که وضعیت مجوز را گزارش می‌دهد:
// سالم (معتبر)، کاهش‌یافته (آزمایشی یا بدون فایل مجوز)، ناسالم (رد شده یا منقضی شده).
public async Task<ActionResult> Index()
{
    var health = Doconut.DoconutHost.Services.GetRequiredService<HealthCheckService>();
    HealthReport report = await health.CheckHealthAsync();

    Response.StatusCode = report.Status == HealthStatus.Unhealthy ? 503 : 200;
    return Content(report.Status.ToString(), "text/plain");
}

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

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

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

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