라이선스

기능, 라이선스 티어 및 라이선스 서비스

이 페이지는 라이선스가 Doconut의 동작을 어떻게 형성하는지에 대한 런타임 레퍼런스입니다: 각 라이선스 상태가 허용하는 것, 기능이 부여되는 방식, 그리고 코드에서 이를 모두 검사하는 방법. (라이선스를 로드하려면, 라이선스 설정을 참조하세요.)

라이선스 상태와 그 역할

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

구독 날짜가 지난 유료 라이선스는 해당 날짜 이전에 출시된 모든 빌드에서 정상적으로 작동하며 — 깨끗하고, 기능이 유지됩니다 —. 그 이후에 출시된 빌드만 거부됩니다.

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

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

기능

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

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

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

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

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

임시 라이선스

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

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

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

IDoconutLicenseService 참조

Resolve IDoconutLicenseService (namespace Doconut.Core.Interfaces) from DoconutHost.Services. It is a singleton — the license is parsed once, in DoconutHost.Initialize:

멤버의미
License전체 DoconutLicenseInfo 스냅샷 (아래)
IsTrial레거시 TRIAL-type 파일 (비인가로 처리 — 권한이 아님)
IsTemporary / ExpiryNote / LicenseExpiry임시 라이선스 마커
IsExpired위 티어 규칙에 따라 만료됨
IsVersionValid이 빌드는 라이선스 지원 기간 내에 해당합니다
IsViewerLicensedNon-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
// GET /Features - UI를 SDK가 사용하는 동일한 진실의 원천에서 feature-flag 하세요
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);
}

상태 확인

Doconut은 라이선스 상태를 보고하는 "doconut" 상태 확인을 등록합니다. 클래식 ASP.NET에는 자체 상태 엔드포인트가 없으므로 컨트롤러에서 이를 노출합니다:

csharp
// GET /Health - Doconut은 "doconut" health check를 등록하여 라이선스 상태를 보고합니다:
// Healthy (valid), Degraded (trial or no license file), Unhealthy (rejected or expired).
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");
}

이를 모니터링에 연결하면 만료되는 구독이 지원 티켓 대신 알림이 됩니다. 라이선스가 거부될 때는 Unhealthy를, IsExpired가 true일 때는 이를 보고합니다; 유료 라이선스의 경우 구독 날짜가 지나고 그 이후에 릴리스된 패키지는 거부된다는 의미이며 — 현재 빌드는 정상적으로 렌더링됩니다. 상태 값은 DoconutHost에서 확인하세요.

버전 업그레이드

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

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