라이선스 설정
Doconut이 라이선스 파일을 찾는 위치
라이선스가 없더라도 Doconut은 문서를 렌더링합니다 — 각 페이지에 평가 워터마크가 표시됩니다. 이 페이지에서는 라이선스를 제공하는 네 가지 방법과 여러 방법이 설정된 경우 정확한 우선순위를 다룹니다.
라이선스를 제공하는 네 가지 방법
네 가지가 있습니다: DoconutOptions에 있는 세 가지 명시적 소스 — 스트림, 원시 내용, 또는 파일 경로 — 그리고 아무 것도 설정되지 않았을 때 자동 검색이 추가됩니다. 여러 개가 설정된 경우, 우선순위는 정확히 다음과 같습니다:
LicenseStream 가 가장 우선이며, 그 다음이 LicenseContent, 그 다음이 LicensePath, 마지막으로 자동 검색이 적용됩니다.
경로별
LicensePath 은(는) File.Exists 에 그대로 전달됩니다. 상대 경로는 프로세스의 현재 작업 디렉터리를 기준으로 해석됩니다 — 프로젝트 폴더가 아니라, Program.cs 가 위치한 폴더도 아닙니다. 경로가 해석되지 않으면 Doconut은 예외를 발생시키지 않으며 자동 검색으로 되돌아가지도 않습니다 — 단순히 라이선스를 로드하지 않아 뷰어에 워터마크가 표시됩니다. 자동 검색은 LicensePath, LicenseContent, 또는 LicenseStream 중 어느 것도 설정되지 않았을 때만 실행됩니다. 동일한 폴더(Doconut.Viewer.<Capability>.lic)에 있는 플러그인별 라이선스 파일도 함께 읽히므로, 플러그인 라이선스가 기본 라이선스와 나란히 있을 때 LicensePath 와 AddPlugin<...>() 가 함께 작동합니다.
절대 경로를 선호하세요 (예: IWebHostEnvironment.WebRootPath 또는 AppContext.BaseDirectory 로 구성된 경우), 또는 LicensePath 를 완전히 생략하고 아래의 자동 검색에 의존하십시오.
builder.Services.AddDoconut(options =>
{
options.LicensePath = Path.Combine(AppContext.BaseDirectory, "wwwroot", "Doconut.Viewer.lic");
});스트림별
LicenseStream 은(는) 시작 시 한 번 읽혀집니다 — 라이선스가 디스크 파일이 아니라 비밀 저장소에서 제공될 때 유용합니다.
// 우선순위: LicenseStream \u003E LicenseContent \u003E LicensePath \u003E 자동 검색.
builder.Services.AddDoconut(options =>
{
options.LicenseStream = licenseStream;
});내용별
LicenseContent 은(는) 라이선스 텍스트 자체를 받아들입니다 — 환경 변수, 데이터베이스, 또는 비밀 관리자에서 가져올 수 있습니다:
// License XML을 데이터베이스, 환경 변수 또는 비밀 관리자에서 가져옵니다 \u2014
// 디스크에 파일이 없습니다. LicenseStream에 의해서만 능가됩니다.
builder.Services.AddDoconut(options =>
{
options.LicenseContent = Environment.GetEnvironmentVariable("DOCONUT_LICENSE") ?? "";
});자동 검색
세 가지 명시적 소스 중 어느 것도 구성하지 않으면, Doconut이 스스로 라이선스를 검색합니다:
// 구성 없이, Doconut이 라이선스를 자체적으로 검색하며, 오직 다음 두 폴더에서만:
// 1. {CurrentDirectory}/wwwroot
// 2. {AppContext.BaseDirectory}/wwwroot (빌드 출력 폴더 내부의 wwwroot)
// 먼저 Doconut.lic을 찾습니다; 없으면 Doconut.Viewer.lic 및 모든
// per-plugin Doconut.Viewer.<Capability>.lic files.
builder.Services.AddDoconut();검색할 폴더 순서와 찾는 파일 이름은 다음과 같습니다:
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 foundwwwroot 폴더 외부의 내용은 읽히지 않습니다: 출력 폴더 자체에 있는 .lic 혹은 wwwroot/lib 은 무시됩니다.
라이선스를 출력 폴더에 복사하기
프로세스가 프로젝트 폴더에서 실행되지 않을 때 — 배포된 앱, IIS, 컨테이너, 테스트 러너 등 — 첫 번째 검색이 실패하고 두 번째 검색인 {AppContext.BaseDirectory}/wwwroot 가 파일을 찾아야 합니다. 이 MSBuild 대상은 매 빌드마다 라이선스를 해당 위치에 복사합니다:
<Target Name="CopyLicensesToOutput" AfterTargets="Build">
<ItemGroup>
<DoconutLicenseFiles Include="$(MSBuildProjectDirectory)\wwwroot\*.lic" />
<StaleOutputLicenses Include="$(OutDir)wwwroot\*.lic" />
</ItemGroup>
<!-- 먼저 삭제하십시오, 따라서 wwwroot에서 .lic 파일을 이름 바꾸거나 제거하면 출력에서도 제외됩니다. -->
<Delete Files="@(StaleOutputLicenses)" />
<Copy SourceFiles="@(DoconutLicenseFiles)" DestinationFolder="$(OutDir)wwwroot" />
</Target>대상은 반드시 $(OutDir)wwwroot 이어야 합니다: 출력 루트에 복사된 .lic 은 자동 검색으로 절대 찾을 수 없습니다. 이 페이지의 LicensePath 예제들은 동일한 위치를 가리킵니다.
소스 제어에
.lic파일을 포함하지 마세요 — 앱과 함께 배포하거나 비밀 저장소에서LicenseContent또는LicenseStream를 통해 라이선스를 주입하십시오.
라이선스 없이 발생하는 일
라이선스가 없다고 오류가 발생하지 않습니다. AddDoconut() 가 성공하고, 앱이 시작되며, 뷰어가 실행됩니다 — 하지만 모든 페이지에 평가 워터마크가 표시되고 선택적 기능은 부여되지 않습니다.
찾았지만 거부된 라이선스 파일은 상황이 다릅니다. 잘못된 서명, 변조, 블랙리스트 등록, 혹은 라이선스 버전 창을 벗어난 빌드 때문에 OpenDocumentAsync 가 LicenseException 를 License.RejectionMessage 와 함께 발생시킵니다. 만료된 임시 라이선스는 워터마크 모드로 계속 동작합니다. 구독 날짜가 지난 유료 라이선스는 해당 날짜 이전에 릴리스된 모든 빌드에서 깨끗하게 기능을 유지하며 동작합니다.
플러그인에는 기능이 필요합니다
해당 권한이 없는 플러그인을 등록하는 경우는 다릅니다: 라이선스가 없거나, 레거시 TRIAL 파일이 있거나, 해당 기능이 없는 유료 라이선스인 경우, AddDoconut() 가 InvalidOperationException 를 발생시켜 앱이 시작되지 않습니다. 예를 들어, Converter 를 부여하는 라이선스 없이 Converter 플러그인을 등록하는 경우:
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.메시지는 직접 해결 방법을 알려줍니다: 해당 플러그인에 대한 options.AddPlugin<...>() 호출을 제거하거나, 기능을 부여하는 유료 라이선스 또는 활성 임시/데모(NFR) 라이선스를 설치하십시오. 임시 등록은 만료일 이후에도 유지될 수 있어 이미 구성된 앱이 재시작 중에 충돌하지 않고 런타임에 기능이 감소하도록 합니다; 만료되면 해당 기능은 여전히 회수됩니다.
로드된 라이선스 확인
IDoconutLicenseService 을 사용하여 SDK에서 사용하는 동일한 진실 소스로 인증된 진단 엔드포인트를 노출하거나 기능 플래그를 제어합니다. 라이선스 내용이나 키를 반환하지 마세요.
app.MapGet("/api/doconut/license", (IDoconutLicenseService license) => Results.Ok(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
}));라이선스는 AddDoconut() 등록 중에 읽혀집니다. ResetLicense 은 현재 활성 재로드 경로가 없는 호환성 속성으로, 라이선스 파일을 교체하려면 애플리케이션을 재시작해야 합니다.
문제 해결 매트릭스
| 증상 | 가능한 원인 | 확인 |
|---|---|---|
| 뷰어는 작동하지만 모든 페이지에 워터마크가 표시됩니다 | 라이선스가 로드되지 않았거나 임시 라이선스가 만료되었습니다 | IDoconutLicenseService 를 해결하고, 출력 디렉터리와 프로세스 작업 디렉터리를 확인하십시오 |
AddDoconut() 가 플러그인에서 오류를 발생시킵니다 | 라이선스가 해당 플러그인 기능을 부여하지 않습니다 | IsCapabilityGranted(...) 를 확인하고 구매하지 않은 등록을 제거하십시오 |
| 구성된 상대 경로가 로컬에서는 작동하지만 IIS/컨테이너에서는 작동하지 않습니다 | 프로세스 작업 디렉터리가 변경되었습니다 | AppContext.BaseDirectory 를 사용하거나 절대 경로를 사용하십시오 |
교체된 .lic 파일이 영향을 주지 않습니다 | 싱글톤 라이선스 서비스가 이미 생성되었습니다 | 애플리케이션을 재시작하십시오 |
OpenDocumentAsync 가 LicenseException 를 발생시킵니다 | 서명, 도메인, 버전 창, 블랙리스트, 혹은 플러그인 런타임 게이트가 라이선스를 거부했습니다 | 신뢰할 수 없는 클라이언트에 노출하지 않고 예외/거부 메시지를 읽으십시오 |
다음 단계
- Licensing — 기능, 라이선스 등급, 그리고 런타임에 로드된 내용을 확인합니다.
- Troubleshooting — 워터마크, 거부된 라이선스, 그리고 기능 오류.
이 페이지가 도움이 되었나요?