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ái | Mở tài liệu? | Dấu watermark | Cá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ông | Nhữ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 watermark | Tấ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ào | Có | 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:
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àyCổng duy nhất mà toàn bộ pipeline sử dụng là IsCapabilityGranted:
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 |
|---|---|
IsTemporary | Mộ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) |
ExpiryNote | Văn bản thông tin nhúng trong giấy phép |
LicenseExpiry | Ngà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) |
IsTrial | Tệ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 / LicenseExpiry | 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 |
IsVersionValid | Bản này nằm trong cửa sổ hỗ trợ của giấy phép |
IsViewerLicensed | Tệ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 HasCompressor | Mộ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 *.* |
LicenseRejectionReason | Khô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.
// 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:
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?