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ả từ mã. (Để tải một giấy phép, xem License Setup.)
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 Full (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 Temporary (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 nước | Tất cả — cấp toàn bộ (kênh đánh giá) |
Giấy phép Temporary đã hết hạn (hết hạn vào ngày LicenseExpiry) | Có | 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ó | Dấu nước đá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, bị liệt kê đen, hoặc bản đượ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 được phát hành trước ngày đó. Chỉ các bản được 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ị 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 thực sự (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 Temporary đã hết hạn vẫn cho phép ứ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ý vẫn hiển thị sạch trên các bản mà nó bao phủ; nhưng việc triển khai một bản được phát hành sau ngày đăng ký của giấy phép sẽ bị từ chối và bị từ chối ngay lập tức với một
LicenseException, vì vậy bạn sẽ phát hiện khi triển khai — không phải bằng cách âm thầm phát hành đầu ra có dấu nước. Ngoại lệ đó (từOpenDocumentAsync) mang lại lý do từLicense.RejectionMessage.
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 theo lựa 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 = Doconut.DoconutHost.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // giấy phép non-TRIAL hiện có AND 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 = Doconut.DoconutHost.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 (chưa 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 chính xác các cờ Has* của nó và là default-deny đối với bất kỳ thứ nào chưa được ánh xạ. (Một tệp loại TRIAL cổ điển 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
Các giấy phép Temporary (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ự 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 temporary 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 temporary 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 đăng ký/cửa sổ cập nhật của nó; đối với giấy phép trả phí, IsExpired chỉ báo rằng ngày này đã qua — các bản đượ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
Giải quyết IDoconutLicenseService (namespace Doconut.Core.Interfaces) từ DoconutHost.Services. Nó là một singleton — giấy phép được phân tích một lần, trong DoconutHost.Initialize:
| Thành viên | Ý nghĩa |
|---|---|
License | Ảnh chụp nhanh đầy đủ của DoconutLicenseInfo (bên dưới) |
IsTrial | Tệp kiểu TRIAL kế thừa (được coi là không có giấy phép — không phải là quyền lợi) |
IsTemporary / ExpiryNote / LicenseExpiry | Các dấu hiệu giấy phép tạm thời |
IsExpired | Đã hết hạn theo các 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ủ — tiền đề cơ bản |
IsCapabilityGranted(cap) | Cổng khả năng duy nhất |
HasSearch HasAnnotation HasEditor HasConverter HasDicom HasDocumentTools HasSigner HasRedactor HasComparer HasForms HasProtector HasCompressor | Một cờ cho mỗi khả năng: được mua bởi giấy phép bao phủ bản dựng này, hoặc được cấp bởi 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 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 với giao diện 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 giấy phép tạm thời, và RejectionMessage.
// GET /Features - feature-flag UI của bạn từ cùng một nguồn sự thật mà SDK sử dụng
public ActionResult Index()
{
var lic = Doconut.DoconutHost.Services.GetRequiredService<IDoconutLicenseService>();
return Json(new
{
viewer = lic.IsViewerLicensed || lic.IsTemporary,
search = lic.IsCapabilityGranted(LicenseCapability.Search),
annotation = lic.IsCapabilityGranted(LicenseCapability.Annotation),
conversion = lic.HasConverter,
dicom = lic.HasDicom,
}, JsonRequestBehavior.AllowGet);
}Kiểm tra sức khỏe
Doconut đăng ký một kiểm tra sức khỏe "doconut" báo cáo trạng thái giấy phép. Classic ASP.NET không có endpoint sức khỏe riêng, vì vậy hãy mở rộng nó từ một controller:
// GET /Health - Doconut đăng ký một "doconut" health check báo cáo trạng thái giấy phép:
// Healthy (hợp lệ), Degraded (dùng thử hoặc không có tệp giấy phép), Unhealthy (bị từ chối hoặc hết hạn).
public async Task<ActionResult> Index()
{
var health = Doconut.DoconutHost.Services.GetRequiredService<HealthCheckService>();
HealthReport report = await health.CheckHealthAsync();
Response.StatusCode = report.Status == HealthStatus.Unhealthy ? 503 : 200;
return Content(report.Status.ToString(), "text/plain");
}Kết nối nó vào hệ thống giám sát của bạn và một thuê bao 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 thuê bao đã qua và một gói được phát hành sau đó sẽ bị từ chối — bản dựng hiện tại vẫn hiển thị sạch sẽ. Xem DoconutHost để biết các giá trị trạng thái.
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 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ì âm thầm gắn watermark vào đầu ra sản xuất. Gia hạn thuê bao, thay thế .lic trong wwwroot, và tái khởi động pool ứng dụng để DoconutHost.Initialize tải giấy phép mới.
Trang này có hữu ích không?