Cấp phép

Các tính 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 khảo thời gian chạy về cách một giấy phép định hình hành vi của Doconut: mỗi trạng thái giấy phép cho phép gì, các tính năng được cấp như thế nào, và cách kiểm tra tất cả từ mã nguồn. (Đố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?Dấu watermarkCác tính 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ôngNhững cái đã 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ó dấu 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 quá ngày LicenseExpiry)CóDấu watermark đánh giáKhông có gì được cấp
Không có tệp giấy phép nàoCóDấu 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ị can thiệp, 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 tính 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ậ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 hiển thị có dấu watermark 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ó 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 việc mở. Một giấy phép tạm thời đã hết hạn giữ cho ứng dụng chạy với dấu 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à ngay lập tức thất bại với một LicenseException, vì vậy bạn sẽ phát hiện nó khi 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 tính năng

Doconut kiểm soát chức năng tùy chọn bằng tính 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 cái đượ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 tính 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 tạm thời hoạt động (không hết hạn) cấp mọi tính năng — bao gồm cả các tính năng chưa có cờ mua riêng; một giấy phép mua thực tế cấp chính xác 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
IsTemporaryMột thẻ 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 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 xem 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 tính năng của chúng.

Tham chiếu IDoconutLicenseService

Tiêm IDoconutLicenseService (namespace Doconut.Core.Interfaces; đăng ký như 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 đủ DoconutLicenseInfo (bên dưới)
IsTrialTệp kiểu TRIAL cũ (được xem như không có giấy phép — không phải là quyền lợi)
IsTemporary / ExpiryNote / LicenseExpiryDấ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 tính năng duy nhất
HasSearch HasAnnotation HasEditor HasConverter HasDicom HasDocumentTools HasSigner HasRedactor HasComparer HasForms HasProtector HasCompressorMột cờ cho mỗi tính năng: được mua bởi 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 tính năng
IsValidForDomain(host)Phạm vi máy chủ; 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 các bảng 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 giao diện người dùng của bạn từ cùng nguồn dữ liệu thực 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 thông qua cơ chế chuẩn 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 đó 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, để một bản cũ hoặc không có giấy phép bị phát hiện khi triển khai thay vì âm thầm gắn watermark vào đầ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?