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ái | Mở tài liệu? | Đánh dấu nước | Khả năng |
|---|---|---|---|
| Giấy phép đầy đủ (đã trả phí) (bản dựng này được phát hành trước ngày đăng ký của nó) | Có | Không | Những 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 đánh dấu nước | 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ủa nó) | Có | Đánh dấu nước đánh giá | Không có gì được cấp |
| Không có tệp giấy phép nào | Có | Đánh dấu nước đánh giá | Không có gì được cấp |
| Đã 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 dựng được 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 dựng được phát hành trước ngày đó. Chỉ các bản dựng 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 nước 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ó dấu nước yêu cầu một giấy phép tạm thời (lấy một).
- Chỉ một giấy phép bị từ chối mới ngăn 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 nước đánh giá, và một giấy phép trả phí sau ngày đăng ký của nó vẫn hiển thị sạch trên các bản dựng mà nó bao phủ; nhưng triển khai một bản dựng được 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ẽ phát hiện nó khi triển khai — không phải bằng cách lặng lẽ phát hành đầu ra có dấu nước. Ngoại lệ đó (từOpenDocumentAsync) mang lại 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 capability. 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 capability — nó là điều kiện tiên quyết, đượ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 đang hoạt động (không hết hạn) cấp mọi capability — bao gồm cả những capability 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 loại TRIAL kế thừa không phải là quyền lợi — nó được xử lý như không có giấy phép: có dấu nước, 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 có mặt (phát hiện dựa trên sự tồn tại của thẻ — không bao giờ khớp với văn bản ghi chú, nó là độ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 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 dựng được 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 đầy đủ DoconutLicenseInfo (bên dưới) |
IsTrial | Tệp loại TRIAL kế thừa (được xử lý như không có giấy phép — không phải là quyền lợi) |
IsTemporary / ExpiryNote / LicenseExpiry | Dấu hiệu temporary-license |
IsExpired | Đã hết hạn theo quy tắc cấp độ ở trên |
IsVersionValid | Bản dựng 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ủ — điều kiện tiên quyết cơ bản |
IsCapabilityGranted(cap) | Cổng capability duy nhất |
HasSearch HasAnnotation HasEditor HasConverter HasDicom HasDocumentTools HasSigner HasRedactor HasComparer HasForms HasProtector HasCompressor | Một cờ cho mỗi capability: được mua bởi giấy phép bao phủ bản dựng 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 capability |
IsValidForDomain(host) | Phạm vi host; 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 thân thiện với người dùng cho các bảng điều khiển quản trị: Owner, LicenseType, Domain, IsLicenseFileFound, IsVersionValid, IsTrial, IsExpired, các cờ Has*, các trường temporary-license, và RejectionMessage.
// Feature-flag UI của bạn từ cùng nguồn dữ liệu thực 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 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 dựng 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 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, vì vậy một bản dựng cũ hoặc không có giấy phép sẽ bị 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ế .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?