라이선스 설정
IIS에서 Doconut이 라이선스 파일을 찾는 위치
라이선스가 없으면 Doconut은 여전히 문서를 렌더링합니다 — 각 페이지에 평가 워터마크가 표시됩니다. 이 페이지에서는 Global.asax에서 라이선스를 제공하는 네 가지 방법, 라이선스를 제공하지 않았을 때 Doconut이 찾는 위치, 그리고 플러그인 라이선스가 누락된 경우에 발생하는 일을 다룹니다.
라이선스를 제공하는 네 가지 방법
DoconutOptions에는 파일 경로, 스트림, 원시 콘텐츠라는 세 가지 명시적 소스가 있습니다 — 이 외에도 설정되지 않았을 때 자동 검색이 있습니다. 모든 소스는 DoconutHost.Initialize에서 한 번 읽힙니다. 둘 이상이 설정된 경우 우선순위는 정확히 다음과 같습니다:
우선순위는 LicenseStream > LicenseContent > LicensePath > 자동 검색이다.
경로별
LicensePath에 전체 경로를 제공하십시오. 상대 경로는 프로세스의 현재 디렉터리를 기준으로 해석되며, IIS에서는 워커 프로세스 자체 폴더가 되므로 사이트 폴더가 아닙니다. HostingEnvironment.MapPath는 사이트 상대 경로를 전체 경로로 변환합니다:
Doconut.DoconutHost.Initialize(options =>
{
options.LicensePath = HostingEnvironment.MapPath("~/wwwroot/Doconut.Viewer.lic");
});파일이 존재하지 않으면 Doconut은 예외를 발생시키지 않으며 자동 검색으로 백업되지 않습니다: 라이선스를 로드하지 않으며 뷰어에 워터마크가 표시됩니다. 동일 폴더에 있는 플러그인별 라이선스 파일(Doconut.Viewer.<Capability>.lic)도 함께 읽히므로, 플러그인 라이선스가 기본 라이선스 옆에 있을 때 LicensePath와 AddPlugin<...>()가 함께 작동합니다.
스트림별
LicenseStream은 시작 시 한 번 읽힙니다 — 라이선스가 디스크 파일이 아니라 임베디드 리소스나 비밀 저장소에서 제공될 때 유용합니다.
// 우선순위: LicenseStream > LicenseContent > LicensePath > 자동 검색.
Doconut.DoconutHost.Initialize(options =>
{
options.LicenseStream = licenseStream;
});콘텐츠별
LicenseContent는 라이선스 텍스트 자체를 받습니다 — 환경 변수, 데이터베이스, 혹은 비밀 저장소에서 — 따라서 사이트와 함께 라이선스 파일을 배포할 필요가 없습니다.
// License XML을 데이터베이스, 환경 변수 또는 비밀 저장소에서 가져옵니다 -
// 디스크에 파일이 없습니다. LicenseStream에 의해서만 능가됩니다.
Doconut.DoconutHost.Initialize(options =>
{
options.LicenseContent = Environment.GetEnvironmentVariable("DOCONUT_LICENSE") ?? "";
});자동 검색
세 가지 중 어느 것도 설정하지 않으면 Doconut이 스스로 라이선스를 검색합니다:
// 아무것도 구성하지 않으며, Doconut이 라이선스를 직접 찾아 다음 순서대로 검색합니다:
// 1. {CurrentDirectory}\wwwroot
// 2. {AppContext.BaseDirectory}\wwwroot (IIS 아래: site's 루트 폴더)
// 먼저 Doconut.lic을 찾습니다; 없으면 Doconut.Viewer.lic과 모든
// 플러그인별 Doconut.Viewer.<Capability>.lic 파일들.
Doconut.DoconutHost.Initialize();다음 두 폴더가 순서대로 검색되며, 찾는 파일은 다음과 같습니다:
1. {CurrentDirectory}\wwwroot
2. {AppContext.BaseDirectory}\wwwroot
Filenames, in order (each one looked for in folder 1, then folder 2):
Doconut.lic — legacy all-in-one license; if found, nothing else is read
Doconut.Viewer.lic — base viewer license
Doconut.Viewer.<Capability>.lic — per-plugin licenses, read only when Doconut.Viewer.lic was foundIIS 및 IIS Express에서는 AppContext.BaseDirectory가 사이트 루트 폴더이며 — Web.config를 포함하는 폴더 — 그 자체의 bin 폴더가 아닙니다. 따라서 라이선스는 사이트 루트 아래의 wwwroot에 위치해야 합니다:
MySite\
Web.config
Global.asax
bin\
wwwroot\
Doconut.Viewer.lic
Doconut.Viewer.Converter.lic프로젝트에서는 wwwroot\*.lic를 Web.config 옆에 두고 사이트와 함께 폴더를 배포하십시오. 빌드 단계에서 별도로 복사할 필요가 없습니다. 다른 곳에 있는 .lic — 예를 들어 bin\ 안에 있거나, Web.config 옆에 있거나, wwwroot의 하위 폴더에 있더라도 — 절대 읽히지 않습니다.
.lic파일을 소스 제어에서 제외하십시오. 사이트와 함께 배포하거나 비밀 저장소에서LicenseContent또는LicenseStream를 통해 라이선스를 제공하십시오.
라이선스가 없을 때 발생하는 일
라이선스가 없다고 예외가 발생하지 않습니다. DoconutHost.Initialize 가 성공하고, 사이트가 시작되며 뷰어가 실행되지만, 모든 페이지에 평가용 워터마크가 표시되고 선택적 기능은 부여되지 않습니다.
하지만 찾았지만 거부된 라이선스 파일은 상황이 다릅니다. 서명이 유효하지 않거나 변조되었거나 라이선스 버전 범위를 벗어난 빌드인 경우 OpenDocumentAsync 가 이유와 함께 LicenseException 를 발생시킵니다. 만료된 임시 라이선스는 워터마크 모드로 계속 동작합니다. 구독 날짜가 지난 유료 라이선스는 해당 날짜 이전에 릴리스된 모든 빌드에서 기능을 유지하며 정상적으로 작동합니다.
플러그인은 시작 시 라이선스가 필요합니다
어떠한 라이선스도 부여하지 않는 기능을 가진 플러그인을 등록하면 애플리케이션이 시작 시 중단됩니다. DoconutHost.Initialize 가 Application_Start 에서 예외를 발생시킵니다:
InvalidOperationException: The Converter plugin is registered via AddPlugin but no active
license grants Converter. Remove the AddPlugin<...>() call or install a license (or
trial/demo) that includes Converter.System.Web 환경에서는 브라우저에 해당 메시지가 표시되지 않습니다. 사이트에 대한 모든 요청은 빈 500 로 응답합니다 — 오류 페이지도 없고, 스택 트레이스도 없으며, IIS 로그에도 아무 기록이 없습니다. 예외는 Windows 이벤트 로그(Application 로그, 소스 ASP.NET)에만 기록됩니다. AddPlugin 라인을 추가한 직후 사이트 전체가 응답을 멈춘다면, 코드 앞에 있는 wwwroot 의 라이선스 파일들을 확인하십시오: 플러그인의 Doconut.Viewer.<Capability>.lic 은 Doconut.Viewer.lic 옆에 위치해야 하며, 기본 라이선스가 없으면 플러그인 파일은 전혀 읽히지 않습니다.
로드된 라이선스 확인
IDoconutLicenseService 은 SDK가 사용하는 동일한 진실의 원천입니다. DoconutHost.Services 로부터 이를 해결하여 인증된 진단 엔드포인트를 노출하거나 기능 플래그를 제어하십시오 — 라이선스 내용을 절대 반환하지 마세요:
// GET /License/Status
public ActionResult Status()
{
var license = Doconut.DoconutHost.Services.GetRequiredService<IDoconutLicenseService>();
return Json(new
{
viewer = license.IsViewerLicensed || license.IsTemporary,
temporary = license.IsTemporary,
search = license.IsCapabilityGranted(LicenseCapability.Search),
annotation = license.IsCapabilityGranted(LicenseCapability.Annotation),
converter = license.HasConverter,
dicom = license.HasDicom
}, JsonRequestBehavior.AllowGet);
}라이선스는 DoconutHost.Initialize 에서 한 번만 읽힙니다. 라이선스 파일을 교체한 후에는 애플리케이션 풀을 재시작(또는 Web.config 를 터치)하여 Application_Start 가 다시 실행되도록 하세요.
문제 해결
| 증상 | 가능한 원인 | 확인 |
|---|---|---|
| 뷰어는 작동하지만 모든 페이지에 워터마크가 표시됩니다 | 라이선스를 찾을 수 없습니다 | .lic 가 <site root>\wwwroot 에 있나요? 위의 상태 엔드포인트를 호출하십시오 |
플러그인을 추가한 직후 모든 요청이 빈 500 로 응답합니다 | 등록된 플러그인에 라이선스가 부여되지 않았습니다 | Windows 이벤트 로그, 소스 ASP.NET; 플러그인의 .lic 가 Doconut.Viewer.lic 옆에 있습니다 |
LicensePath 가 로컬 머신에서는 작동하지만 서버에서는 작동하지 않습니다 | 작업자 프로세스 폴더를 기준으로 해석되는 상대 경로 | HostingEnvironment.MapPath("~/wwwroot/...") 로 빌드하십시오 |
교체한 .lic 파일이 효과가 없습니다 | 애플리케이션 시작 시 라이선스가 읽혔습니다 | 애플리케이션 풀을 재시작하십시오 |
OpenDocumentAsync 가 LicenseException 를 발생시킵니다 | 라이선스를 찾았지만 거부되었습니다 | 예외 메시지를 확인하십시오; 신뢰할 수 없는 클라이언트에게는 표시하지 마세요 |
다음 단계
이 페이지가 도움이 되었나요?