라이선스

기능, 라이선스 등급 및 라이선스 서비스

이 페이지는 라이선스가 Doconut의 동작을 어떻게 형성하는지에 대한 런타임 레퍼런스이며, 각 라이선스 상태가 허용하는 내용, 기능이 부여되는 방식, 그리고 코드에서 이를 모두 검사하는 방법을 설명합니다. (라이선스를 로드하는 방법은 시작하기 → 라이선스 설정을 참고하십시오.)

라이선스 상태와 기능

상태문서 열기 여부워터마크기능
전체(유료) 라이선스 (이 빌드는 구독 날짜 이전에 릴리스되었습니다)예없음구매된 것들 (Has* 플래그)
임시 라이선스 (Developer/NFR — 평가 라이선스, 만료 날짜 이전)예기본 뷰어에서는 없음; 플러그인 출력은 워터마크가 적용됨전체 — 일괄 부여 (평가 퍼널)
만료된 임시 라이선스 (LicenseExpiry 날짜가 지난 경우)예평가 워터마크부여된 것이 없음
라이선스 파일이 전혀 없음예평가 워터마크부여된 것이 없음
발견되었지만 거부됨 (서명 무효, 변조, 블랙리스트, 또는 라이선스 구독 날짜 이후에 릴리스된 빌드)아니오 — 모든 열기에서 LicenseException——

구독 날짜가 지난 유료 라이선스는 해당 날짜 이전에 릴리스된 모든 빌드에서 깨끗하게, 기능과 함께 계속 작동합니다. 해당 날짜 이후에 릴리스된 빌드만 거부됩니다.

내부화할 가치가 있는 두 가지 결과:

  • 라이선스가 없다는 것은 임시 라이선스가 아닙니다. 라이선스 파일이 없으면 페이지에 워터마크가 표시되고 기능(검색, 주석, 플러그인)이 활성화되지 않습니다. 전체 기능을 갖춘 워터마크 없는 경험을 위해서는 실제 임시 라이선스가 필요합니다 (받으세요).
  • 거부된 라이선스만 열기를 차단합니다. 만료된 임시 라이선스는 평가 워터마크와 함께 앱을 계속 실행하고, 구독 날짜가 지난 유료 라이선스는 해당 라이선스가 적용되는 빌드에서 깨끗하게 렌더링됩니다; 그러나 라이선스 구독 날짜 이후에 릴리스된 빌드를 배포하면 거부되고 빠르게 실패하며 LicenseException가 발생하므로 배포 시에 이를 포착할 수 있습니다 — 워터마크가 적용된 출력을 조용히 배포하는 것이 아니라. 해당 예외(OpenDocumentAsync)는 License.RejectionMessage에서 온 이유를 포함합니다.

기능

Doconut는 기능을 통해 선택적 기능을 제어합니다. 여기에는 기본 제공 검색 및 주석 기능과 선택 가능한 컨버터, Dicom, Signer 플러그인이 포함되며, 각각은 라이선스에 의해 부여됩니다. 기본 뷰어는 기능이 아니라 전제 조건이며, IsViewerLicensed로 표시됩니다:

csharp
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // non-TRIAL 라이선스가 존재하고 이 빌드의 버전을 포함합니다

전체 파이프라인이 사용하는 단일 게이트는 IsCapabilityGranted입니다:

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

그 로직은 구현에서 그대로 가져온 것입니다: 활성(만료되지 않은) 임시 라이선스는 모든 기능을 부여합니다 — 아직 전용 구매 플래그가 없는 기능도 포함합니다; 실제 구매된 라이선스는 정확히 그 Has* 플래그만 부여하며 매핑되지 않은 모든 항목에 대해 기본 거부합니다. (레거시 TRIAL 유형 파일은 권한이 아니며 라이선스가 없는 것으로 처리됩니다: 워터마크가 적용되고, 아무 것도 부여되지 않음.)

임시 라이선스

임시(Developer/NFR) 라이선스는 ExpiryNote 태그로 표시되며 강제 만료 날짜를 가집니다:

멤버의미
IsTemporaryExpiryNote 태그가 존재합니다 (탐지는 태그 존재 여부로 이루어지며 — 메모 텍스트와 일치하지 않으며, 동적입니다)
ExpiryNote라이선스에 삽입된 정보 텍스트
LicenseExpiry강제 만료 날짜 (DateTime?)

만료 의미는 등급에 따라 다릅니다: 임시 라이선스는 LicenseExpiry 날짜만 기준으로 만료됩니다(구독 기간은 무시됩니다; 날짜가 없는 임시 라이선스는 만료된 것으로 처리되어 안전하게 동작합니다). 다른 모든 라이선스는 구독/업데이트 기간 날짜에 따라 만료됩니다; 유료 라이선스의 경우, IsExpired는 이 날짜가 지났음을 보고할 뿐이며 — 그 이전에 릴리스된 빌드는 깨끗하게 유지되고 기능을 유지합니다.

IDoconutLicenseService 참조

IDoconutLicenseService를 주입합니다 (네임스페이스 Doconut.Core.Interfaces; 싱글톤으로 등록 — 라이선스는 시작 시 한 번 파싱됩니다):

멤버의미
License전체 DoconutLicenseInfo 스냅샷 (아래)
IsTrial레거시 TRIAL 유형 파일 (라이선스가 없는 것으로 처리 — 권한이 아님)
IsTemporary / ExpiryNote / LicenseExpiry임시 라이선스 마커
IsExpired위 등급 규칙에 따라 만료됨
IsVersionValid이 빌드는 라이선스 지원 기간 내에 해당합니다
IsViewerLicensed비-TRIAL 파일이 발견되고 버전이 포함됨 — 기본 전제 조건
IsCapabilityGranted(cap)단일 기능 게이트
HasSearch HasAnnotation HasEditor HasConverter HasDicom HasDocumentTools HasSigner HasRedactor HasComparer HasForms HasProtector HasCompressor기능당 하나의 플래그: 이 빌드를 포함하는 라이선스에 의해 구매되었거나 활성 임시 라이선스에 의해 부여됩니다. IsCapabilityGranted는 기능별로 동일한 질문에 답합니다
IsValidForDomain(host)호스트 커버리지; V4 라이선스는 와일드카드 *.*를 사용합니다
LicenseRejectionReason비어 있지 않음 ⇒ 이 메시지와 함께 열기가 차단됩니다

DoconutLicenseInfo는 관리자 패널을 위한 표시 친화적인 스냅샷을 노출합니다: Owner, LicenseType, Domain, IsLicenseFileFound, IsVersionValid, IsTrial, IsExpired, Has* 플래그, 임시 라이선스 필드, 그리고 RejectionMessage.

csharp
// Feature-flag 귀하의 UI를 SDK가 사용하는 동일한 진실의 소스에서 가져옵니다
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,
}));

헬스 체크

AddDoconut()는 표준 ASP.NET Core 메커니즘을 통해 라이선스/만료 상태를 보고하는 "doconut" 헬스 체크를 등록합니다:

csharp
app.MapHealthChecks("/health");

이를 모니터링에 연결하면 만료되는 구독이 지원 티켓이 아닌 알림이 됩니다. 체크는 라이선스가 거부될 때 또는 IsExpired가 true일 때 Unhealthy를 보고합니다; 유료 라이선스의 경우, 이는 구독 날짜가 지나고 그 이후에 릴리스된 패키지가 거부된다는 의미이며 — 현재 빌드는 깨끗하게 렌더링됩니다.

버전 업그레이드

라이선스는 버전 윈도우를 포함합니다. NuGet 패키지를 해당 윈도우보다 새로운 빌드로 업데이트하면 이 빌드에 대한 라이선스가 무효가 됩니다: IsVersionValid가 false로 전환되고 열기가 차단되며 LicenseException가 표시됩니다(이유는 License.RejectionMessage에 있음) — 의도적으로 빠르게 실패하도록 하여, 오래되거나 라이선스가 없는 빌드가 배포 시에 포착되고 생산 출력에 조용히 워터마크가 적용되는 것을 방지합니다. 구독을 갱신하고 .lic를 교체한 뒤 애플리케이션을 재시작하면 AddDoconut()가 새로운 라이선스를 로드합니다.

이 페이지가 도움이 되었나요?