Cấp phép

Các khả năng, cấp độ giấy phép và dịch vụ giấy 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 khả 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 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

Trạng tháiMở tài liệu?WatermarkKhả năng
Giấy phép đầy đủ (đã trả phí) (bản này được phát hành trước ngày đăng ký)CóKhôngCác cờ đã mua (Has* flags)
Giấy phép tạm thời (Developer/NFR — giấy phép đánh giá, trước ngày hết hạn)CóKhông trên trình xem cơ bản; đầu ra plugin có watermarkTất cả — cấp toàn bộ (kênh đánh giá)
Giấy phép tạm thời đã hết hạn (vượt qua ngày LicenseExpiry)CóWatermark đánh giáKhông có gì được cấp
Không có tệp giấy phép nàoCóWatermark đánh giáKhông có gì được cấp
Được tìm thấy nhưng bị từ chối (chữ ký không hợp lệ, bị giả mạo, nằm trong danh sách đen, hoặc bản phát hành sau ngày đăng ký của giấy phép)Không — LicenseException trên mỗi lần mở——

Một giấy phép trả phí mà ngày đăng ký đã qua vẫn hoạt động — sạch sẽ, với các khả năng của nó — trên mọi bản phát hành trước ngày đó. Chỉ các bản phát hành sau ngày đó mới bị từ chối.

Hai hệ quả đáng ghi nhớ:

  • 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 hiển thị có watermark và không có khả 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ó watermark 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 mở. Giấy phép tạm thời đã hết hạn giữ cho ứng dụng chạy với watermark đánh giá, và một giấy phép trả phí sau ngày đăng ký vẫn hiển thị sạch trên các bản mà nó bao phủ; nhưng triển khai một bản phát hành sau ngày đăng ký 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 lỗi tại thời điểm triển khai — không phải bằng cách âm thầm phát hành đầu ra có watermark. Ngoại lệ đó (từ OpenDocumentAsync) mang lý do từ License.RejectionMessage.

Các khả năng

Doconut kiểm soát chức năng tùy chọn bằng khả năng. Nó bao gồm các tính năng Search và Annotation tích hợp sẵn và các plugin Converter, Dicom và Signer tùy chọn, mỗi plugin đượ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 khả năng — nó là tiền đề, được hiển thị dưới dạng IsViewerLicensed:

csharp
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // giấy phép non-TRIAL hiện có VÀ bao phủ phiên bản của bản dựng này

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

csharp
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool searchGranted = lic.IsCapabilityGranted(LicenseCapability.Search);

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

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

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:

Thành viênÝ nghĩa
IsTemporaryThẻ ExpiryNote hiện diện (phát hiện dựa trên sự hiện diện của thẻ — không bao giờ khớp với văn bản ghi chú, nó động)
ExpiryNoteVăn bản thông tin nhúng trong giấy phép
LicenseExpiryNgày hết hạn cố định (DateTime?)

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 nó (cửa sổ đăng ký 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; đối với giấy phép trả phí, IsExpired chỉ báo rằng ngày này đã qua — các bản phát hành trước ngày đó vẫn sạch và giữ các khả năng của chúng.

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):

Thành viênÝ nghĩa
LicenseẢnh chụp nhanh đầy đủ của DoconutLicenseInfo (bên dưới)
IsTrialTệp kiểu TRIAL cũ (được xử lý như không có giấy phép — không phải là quyền lợi)
IsTemporary / ExpiryNote / LicenseExpiryCác dấu hiệu giấy phép tạm thời
IsExpiredĐã hết hạn theo quy tắc cấp độ ở trên
IsVersionValidBản này nằm trong cửa sổ hỗ trợ của giấy phép
IsViewerLicensedTệp không phải TRIAL được tìm thấy và phiên bản được bao phủ — tiền đề cơ bản
IsCapabilityGranted(cap)Cổng duy nhất cho khả năng
HasSearch HasAnnotation HasEditor HasConverter HasDicom HasDocumentTools HasSigner HasRedactor HasComparer HasForms HasProtector HasCompressorMột cờ cho mỗi khả năng: được mua bởi một giấy phép bao phủ bản này, hoặc được cấp bởi một giấy phép tạm thời đang hoạt động. IsCapabilityGranted trả lời cùng câu hỏi theo khả năng
IsValidForDomain(host)Phạm vi host; giấy phép V4 sử dụng ký tự đại diện *.*
LicenseRejectionReasonKhông rỗng ⇒ việc mở bị chặn với thông báo này

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

csharp
// Feature-flag UI của bạn từ cùng nguồn sự thật mà SDK sử dụng
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 qua cơ chế chuẩn của ASP.NET Core:

csharp
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ợ. Kiểm tra báo cáo Unhealthy khi giấy phép bị từ chối hoặc IsExpired là đúng; đối với giấy phép trả phí, điều này có nghĩa là ngày đăng ký đã qua và một gói phát hành sau ngày đó sẽ bị từ chối — bản hiện tại vẫn hiển thị sạch.

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 mới hơn cửa sổ đó làm cho giấy phép không hợp lệ cho bản 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, vì vậy một bản cũ hoặc không có giấy phép sẽ bị phát hiện khi triển khai thay vì âm thầm gắn watermark lên đầu ra sản xuất. Gia hạn đăng ký, thay thế .lic, và khởi động lại ứng dụng để AddDoconut() tải giấy phép mới.

Trang này có hữu ích không?