Cấp phép

Trang này là tài liệu tham chiếu thời gian chạy về cách một giấy phép định hình hành vi của Doconut: những gì mỗi trạng thái giấy phép cho phép, cách các tính năng được cấp, và cách kiểm tra tất cả chúng từ mã. (Đối với tải một giấy phép, xem Hướng dẫn bắt đầu → Cài đặt giấy phép.)

Các trạng thái giấy phép và chức năng của chúng

Hai hậu quả đáng lưu ý:

• Một giấy phép thiếu không phải là giấy phép tạm thời. Khi không có tệp giấy phép, các trang sẽ hiển thị có đánh dấu nước và không có tính năng nào (tìm kiếm, chú thích, plugin) hoạt động. Trải nghiệm đầy đủ tính năng, không có đánh dấu nước yêu cầu một Giấy phép tạm thời thực tế (lấy một).
• Chỉ một giấy phép bị từ chối mới ngăn việc mở. Hết hạn lịch/đăng ký chỉ làm giảm xuống việc hiển thị có đánh dấu nước; nhưng triển khai một bản dựng mới hơn cửa sổ phiên bản của giấy phép sẽ bị từ chối và thất bại nhanh với một LicenseException, vì vậy bạn sẽ bắt được nó khi triển khai — không phải bằng cách lặng lẽ phát hành đầu ra có đánh dấu nước. Ngoại lệ đó (từ OpenDocumentAsync) mang lại lý do từ License.RejectionMessage.

Các tính năng

Doconut kiểm soát chức năng tùy chọn bằng công năng. Hiện nay, đó là các plugin Converter và DICOM có thể bật cộng với các tính năng tích hợp Search và Annotation, mỗi tính năng được cấp bởi giấy phép của bạn. Trình xem cơ bản không phải là một công năng — nó là điều kiện tiên quyết, được biểu thị bằng IsViewerLicensed:

bool viewerLicensed = lic.IsViewerLicensed; // non-TRIAL license present AND covering this build's version

Cổng duy nhất mà toàn bộ pipeline sử dụng là IsCapabilityGranted:

bool searchGranted = lic.IsCapabilityGranted(LicenseCapability.Search);

Logic của nó, sao chép nguyên văn từ triển khai: một giấy phép Temporary (không hết hạn) đang hoạt động sẽ cấp mọi công năng — bao gồm cả các công năng chưa có cờ mua riêng; một giấy phép đã mua thực tế sẽ cấp chính xác các cờ Has* của nó và mặc định từ chối bất kỳ công năng nào chưa được ánh xạ. (Một tệp kiểu TRIAL cũ không phải là một quyền lợi — nó được xử lý như không có giấy phép: có đánh dấu nước, không có gì được cấp.)

Giấy phép tạm thời

Tìm kiếm và Chú thích bình thường sử dụng các công năng hiện có của chúng một cách trực tiếp.

Giấy phép tạm thời (Developer/NFR) được đánh dấu bằng thẻ ExpiryNote và có ngày hết hạn cố định:

Ngữ nghĩa hết hạn khác nhau theo cấp: một giấy phép tạm thời hết hạn vào ngày LicenseExpiry (cửa sổ đăng ký của nó bị bỏ qua; một giấy phép tạm thời thiếu ngày sẽ được coi là đã hết hạn, an toàn). Mọi giấy phép khác hết hạn vào ngày cửa sổ đăng ký/cập nhật của nó.

Tham chiếu IDoconutLicenseService

Tiêm IDoconutLicenseService (namespace Doconut.Core.Interfaces; đăng ký dưới dạng singleton — giấy phép được phân tích một lần khi khởi động):

DoconutLicenseInfo cung cấp ảnh chụp thân thiện với giao diện hiển thị cho các bảng quản trị: Owner, Email, LicenseType, Domain, IsLicenseFileFound, IsVersionValid, IsTrial, IsExpired, các cờ Has*, các trường giấy phép tạm thời, và RejectionMessage.

// Feature-flag your UI from the same source of truth the SDK uses
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,
}));

Kiểm tra sức khỏe

AddDoconut() đăng ký một kiểm tra sức khỏe "doconut" báo cáo trạng thái giấy phép/hết hạn thông qua cơ chế chuẩn của ASP.NET Core:

app.MapHealthChecks("/health");

Kết nối nó vào hệ thống giám sát của bạn và một đăng ký sắp hết hạn sẽ trở thành cảnh báo thay vì phiếu hỗ trợ.

Nâng cấp phiên bản

Một giấy phép bao phủ một cửa sổ phiên bản. Cập nhật gói NuGet lên một bản dựng mới hơn cửa sổ đó làm cho giấy phép không hợp lệ cho bản dựng này: IsVersionValid chuyển thành false và việc mở bị chặn bằng một LicenseException (lý do nằm trong License.RejectionMessage) — cố ý thất bại nhanh, để một bản dựng lỗi thời hoặc không có giấy phép được phát hiện khi triển khai thay vì lặng lẽ đánh dấu nước đầu ra sản xuất. Gia hạn đăng ký, thay thế file .lic, và khởi động lại ứng dụng để AddDoconut() tải giấy phép mới.