많은 개발자들은 웹 애플리케이션에서 문서를 표시해야 할 때 UI 컴포넌트 라이브러리를 찾는 것으로 시작합니다. Doconut Viewer 는 ASP.NET Core, MVC 또는 클래식 WebForms 프로젝트에 플러그인‑없는 브라우저 뷰어를 추가하기 위한 .NET SDK입니다. 보안은 여전히 전체 애플리케이션 아키텍처에 따라 달라집니다: 인증, 인가, 전송, 저장, 검증, 정리, 패치 및 모니터링.
1. Doconut App SDK 설치 및 다중 파일 형식을 위한 .NET 프로젝트 준비
1.1 지원 패키지 추가
공식 Doconut 다운로드 페이지 에서 현재 패키지와 설정 지침을 사용하십시오. 선택한 버전을 기록하고 대상 .NET 런타임을 지원하는지 확인합니다.
1.2 패키지 참조 확인
설치 후, 프로젝트 파일에서 패키지 참조와 해결된 버전을 확인합니다. 버전을 명시적으로 유지하면 빌드와 배포를 재현 가능하게 만드는 데 도움이 됩니다.
1.3 HTTPS 활성화
Doconut App은 모든 파일 업로드에 SSL을 요구합니다. 애플리케이션이 HTTPS를 수신하도록 확인하십시오. Kestrel‑호스팅 앱의 경우, appsettings.json에 엔드포인트 구성을 추가합니다:
{
"Kestrel": {
"Endpoints": {
"Https": {
"Url": "
}
}
}
}
IIS에서 호스팅하는 경우, 사이트에 HTTPS 인증서를 바인딩하십시오. HTTPS가 활성화되면 모든 파일이 Doconut App의 렌더링 엔진에 도달하기 전에 보안 채널을 통해 전송됩니다.
왜 Doconut App인가?
Doconut App은 제로‑플러그인 렌더링과 엔드‑투‑엔드 AES‑256 암호화를 결합한 유일한 .NET‑네이티브 뷰어로, 추가 인프라를 도입하지 않고도 규정 준수 요구 사항을 충족할 수 있게 해줍니다.
2. 문서 관리를 위한 보안 파일 업로드 및 저장 구성
Doconut App의 보안 모델은 세 가지 기둥을 기반으로 합니다: SSL 전송, 저장 시 AES‑256 암호화, 그리고 보기 후 자동 삭제. SDK는 애플리케이션에 등록할 수 있는 즉시 사용 가능한 서비스를 제공합니다.
2.1 업로드 서비스 등록
Startup.cs (또는 .NET 6+의 경우 Program.cs) 에서 Doconut 서비스를 의존성 주입 컨테이너에 추가합니다. 임시 저장 폴더를 구성하고, AES‑256 암호화를 활성화하며, 자동 삭제 간격을 설정합니다(예: 문서가 조회된 후 10 분).
2.2 업로드 엔드포인트 생성
업로드된 파일을 수신하고 이를 Doconut 서비스에 전달하여 보안 저장을 수행한 뒤 짧은 일회성 토큰을 반환하는 컨트롤러 액션을 구현합니다. 이 토큰은 클라이언트‑사이드 뷰어가 문서를 가져오고 렌더링하는 데 사용됩니다.
2.3 엔드포인트 보호
업로드 엔드포인트는 민감한 데이터를 다루므로 인증 및 역할 기반 인가로 보호합니다(예: DocumentViewer 역할을 가진 사용자만 업로드 가능). 이를 통해 권한이 있는 직원만 기밀 문서를 저장하고 볼 수 있습니다.
Doconut App 장점: SDK가 암호화와 정리를 대신 처리하므로, 직접 암호화 코드를 작성하거나 고아 파일에 대해 걱정할 필요가 없습니다.
3. ASP.NET Core, MVC, 또는 WebForms에 뷰어 컴포넌트 삽입
백엔드가 준비되면, 설치된 Doconut 버전에 대한 자산 및 API를 사용하여 뷰어를 초기화합니다.
3.1 JavaScript 번들 추가
공유 레이아웃에 설치된 SDK와 일치하는 문서에 설명된 뷰어 리소스만 포함하십시오. 버전마다 고정된 번들 이름이나 위치를 가정하지 마세요.
3.2 Core/MVC용 Razor 뷰 생성
Views/Document/View.cshtml 와 같이 파일 입력, 뷰어용 컨테이너 요소, 선택된 파일을 업로드하고 보안 토큰을 받아 Doconut Viewer 위젯을 초기화하는 작은 스크립트를 포함하는 뷰를 추가합니다.
스크립트는:
\<input type="file"\>요소에서 선택된 파일을 캡처합니다.fetch또는XMLHttpRequest를 사용해 파일을 업로드 엔드포인트로 전송합니다.- 인증된 응답이 도착하면, 설치된 버전에 대한 지원 API를 사용해 뷰어를 초기화합니다.
3.3 WebForms 등가 구현
WebForms 페이지(예: DocumentViewer.aspx)에 asp:FileUpload 컨트롤, 업로드를 트리거하는 버튼, 그리고 뷰어를 호스팅할 <div>를 배치합니다. 코드‑비하인드에서 Doconut 서비스를 호출해 업로드된 파일을 저장하고 토큰을 얻은 뒤, JavaScript 함수(initViewer(token))를 호출하는 시작 스크립트를 등록하여 뷰어 인스턴스를 생성합니다.
Doconut App의 이점: 하나의 JavaScript 위젯, 세 가지 .NET UI 모델, 추가 라이브러리 없이. 최고의 단순함.
4. 문서 관리를 위한 뷰어 맞춤 설정
기본 제공되는 Doconut Viewer는 깔끔한 툴바, 줌 컨트롤, 그리고 밝기/어두움 테마 토글을 제공합니다. UI를 브랜드에 맞게 그리고 특정 문서 유형에 맞게 조정할 수 있습니다.
4.1 툴바 구성
뷰어를 초기화할 때, 표시할 툴바 항목을 지정할 수 있습니다(예: download, print, zoomIn, zoomOut, fullScreen). 예를 들어 download 버튼을 제거하면 사용자가 원본 파일을 저장하는 것을 방지합니다.
4.2 테마 및 색상
theme 옵션을 'dark' 또는 'light' 로 설정하고, 필요에 따라 기업 색상표에 맞는 primaryColor 를 제공할 수 있습니다. 뷰어는 CSS 변수를 존중하므로 커스텀 스타일시트를 통해 보다 깊은 스타일링이 가능합니다.
4.3 CAD 전용 도구
DWG, DXF, DGN 파일을 표시하는 경우, CAD 옵션 enableMeasurement 와 enableLayerToggle 을 활성화하십시오. 이렇게 하면 거리, 각도, 면적 측정 도구와 레이어 가시성 패널이 툴바에 직접 추가됩니다.
4.4 현지화
초기화 시 locale 코드를 전달합니다(예: 프랑스어는 'fr'). 모든 UI 문자열, 툴팁 및 오류 메시지가 선택된 언어로 표시됩니다.
왜 맞춤 설정을 할까요? Doconut App은 뷰어가 사이트의 자연스러운 확장처럼 보이게 하면서도 동일한 보안, 플러그인‑없는 경험을 제공하게 해줍니다.
5. 모든 지원 형식에 대한 통합 테스트
실서비스에 앞서, 사용자가 볼 것으로 예상되는 각 파일 유형에 대해 간단한 검증을 수행하십시오. Doconut App의 뷰어를 사용해 각 형식의 샘플 파일을 열고 렌더링, 탐색 및 특수 도구가 설명대로 작동하는지 확인합니다.
| 형식 | 테스트 시나리오 | 예상 결과 |
|---|---|---|
| 이미지를 포함한 대형 다중 페이지 보고서 | 부드러운 스크롤, 줌, 정확한 색상 렌더링 | |
| DOCX | 표와 각주가 포함된 Word 문서 | 모든 텍스트, 표, 각주가 표시되고 레이아웃 이동이 없음 |
| XLSX | 차트가 포함된 스프레드시트 | 차트가 벡터 그래픽으로 렌더링되고 줌 시 선명도 유지 |
| PPTX | 정적 미리보기가 있는 슬라이드 데크 | 첫 슬라이드가 올바르게 표시되고 손상된 자산이 없음 |
| DWG | 다중 레이어가 있는 기술 도면 | 레이어 토글, 측정 기능 작동, 선이 선명함 |
| PSD | 레이어가 있는 Photoshop 파일 | 레이어가 보이고 색상이 정확하며 줌 시 선명함 유지 |
| SVG | 그라디언트가 있는 벡터 그래픽 | 그라디언트가 부드럽게 렌더링되고 줌 시 선명함 유지 |
| TIFF | 고해상도 스캔 | 이미지가 빠르게 로드되고 줌 시 세부 사항이 드러남 |
결론
Doconut App을 사용하면 보안된 플러그인‑없는 문서 뷰어를 삽입하는 것이 이제 간단합니다. 위 단계—SDK 설치, 암호화된 업로드 구성, 가벼운 JavaScript 위젯 삽입, UI 맞춤 설정—를 따라 하면 ASP.NET Core, MVC 및 WebForms 애플리케이션 전반에 빠르고 고품질의 문서 렌더링을 제공할 수 있습니다.
평가할 준비가 되셨나요? 공식 Doconut 다운로드 및 문서 페이지부터 시작하고, 나머지 Windows 기반 ASP.NET 애플리케이션에 적용된 동일한 보안 검토와 함께 SDK를 테스트하십시오.