Nhiều nhà phát triển bắt đầu bằng cách tìm kiếm các thư viện thành phần UI khi họ cần hiển thị tài liệu trong một ứng dụng web. Trình xem Doconut là một SDK .NET để thêm khả năng xem trong trình duyệt không cần plugin vào các dự án ASP.NET Core, MVC hoặc WebForms cổ điển. Bảo mật vẫn phụ thuộc vào kiến trúc toàn bộ ứng dụng: xác thực, ủy quyền, truyền tải, lưu trữ, kiểm tra, dọn dẹp, vá lỗi và giám sát.
1. Cài đặt SDK Doconut App và Chuẩn bị Dự án .NET của Bạn cho Nhiều Định dạng Tệp
1.1 Thêm gói hỗ trợ
Sử dụng gói hiện tại và hướng dẫn cài đặt từ trang tải Doconut chính thức. Ghi lại phiên bản đã chọn và xác minh rằng nó hỗ trợ môi trường .NET mục tiêu.
1.2 Xác minh tham chiếu gói
Sau khi cài đặt, xác nhận tham chiếu gói và phiên bản đã giải quyết trong tệp dự án. Giữ các phiên bản rõ ràng giúp quá trình xây dựng và triển khai có thể tái tạo được.
1.3 Kích hoạt HTTPS
Doconut App yêu cầu SSL cho mọi tải lên tệp. Đảm bảo ứng dụng của bạn lắng nghe trên HTTPS. Đối với ứng dụng được Kestrel‑host, thêm cấu hình endpoint trong appsettings.json:
{
"Kestrel": {
"Endpoints": {
"Https": {
"Url": "
}
}
}
}
Nếu bạn triển khai trên IIS, gắn chứng chỉ HTTPS vào site. Khi HTTPS được bật, mọi tệp sẽ truyền qua kênh bảo mật trước khi đến engine render của Doconut App.
Tại sao Doconut App?
Doconut App là trình xem duy nhất native .NET kết hợp render không cần plugin với mã hóa AES‑256 đầu‑cuối, cho phép bạn đáp ứng các yêu cầu tuân thủ mà không cần thêm hạ tầng.
2. Cấu hình Tải lên Tệp Bảo mật và Lưu trữ cho Quản lý Tài liệu
Mô hình bảo mật của Doconut App dựa trên ba trụ cột: truyền tải SSL, mã hóa AES‑256 khi lưu và tự động xóa sau khi xem. SDK cung cấp một dịch vụ sẵn có mà bạn có thể đăng ký trong ứng dụng.
2.1 Đăng ký dịch vụ tải lên
Trong Startup.cs (hoặc Program.cs cho .NET 6+), thêm các dịch vụ Doconut vào container tiêm phụ thuộc. Cấu hình thư mục lưu trữ tạm thời, bật mã hóa AES‑256 và đặt khoảng thời gian tự xóa (ví dụ, 10 phút sau khi tài liệu được xem).
2.2 Tạo endpoint tải lên
Triển khai một hành động controller nhận tệp tải lên, chuyển nó cho dịch vụ Doconut để lưu trữ an toàn và trả về một token ngắn dùng một lần. Token này là gì mà trình xem phía client sẽ dùng để lấy và render tài liệu.
2.3 Bảo vệ endpoint
Vì endpoint tải lên xử lý dữ liệu nhạy cảm, hãy bảo vệ nó bằng xác thực và ủy quyền dựa trên vai trò (ví dụ, chỉ người dùng trong vai trò DocumentViewer mới được phép tải lên). Điều này đảm bảo chỉ những nhân sự được ủy quyền mới có thể lưu và xem các tài liệu bí mật.
Lợi thế của Doconut App: SDK xử lý mã hóa và dọn dẹp cho bạn, vì vậy bạn không bao giờ phải viết mã cryptography tùy chỉnh hay lo lắng về các tệp bỏ rơi.
3. Nhúng Thành phần Trình xem vào ASP.NET Core, MVC hoặc WebForms
Khi backend đã sẵn sàng, khởi tạo trình xem bằng các tài nguyên và API được tài liệu hoá cho phiên bản Doconut đã cài đặt.
3.1 Thêm bundle JavaScript
Trong layout chia sẻ, bao gồm chỉ các tài nguyên trình xem được mô tả trong tài liệu phù hợp với SDK đã cài đặt. Đừng giả định tên bundle hay vị trí cố định giữa các phiên bản.
3.2 Tạo Razor view cho Core/MVC
Thêm một view (ví dụ, Views/Document/View.cshtml) chứa input tệp, một phần tử container cho trình xem và một script nhỏ tải tệp đã chọn lên, nhận token bảo mật và khởi tạo widget Doconut Viewer.
Script cần:
- Lấy tệp đã chọn từ phần tử
<input type="file">. - Gửi tệp tới endpoint tải lên bằng
fetchhoặcXMLHttpRequest. - Khi nhận được phản hồi đã ủy quyền, khởi tạo trình xem bằng API hỗ trợ của phiên bản đã cài đặt.
3.3 Tương đương WebForms
Trong một trang WebForms (ví dụ, DocumentViewer.aspx), đặt một điều khiển asp:FileUpload, một nút để kích hoạt tải lên và một <div> sẽ chứa trình xem. Trong code‑behind, gọi dịch vụ Doconut để lưu tệp đã tải lên, lấy token và đăng ký script khởi động gọi hàm JavaScript (initViewer(token)) để tạo instance trình xem.
Lợi ích của Doconut App: Một widget JavaScript, ba mô hình UI .NET, không cần thư viện bổ sung. Đơn giản nhất có thể.
4. Tùy chỉnh Trình xem cho Quản lý Tài liệu
Ngay từ đầu, Doconut Viewer cung cấp thanh công cụ sạch sẽ, điều khiển thu phóng và công tắc chế độ sáng/tối. Bạn có thể tùy chỉnh UI để phù hợp với thương hiệu và các loại tài liệu cụ thể.
4.1 Cấu hình thanh công cụ
Khi khởi tạo trình xem, bạn có thể chỉ định các mục thanh công cụ sẽ hiển thị (ví dụ, download, print, zoomIn, zoomOut, fullScreen). Việc loại bỏ nút download sẽ ngăn người dùng lưu tệp gốc.
4.2 Chủ đề và màu sắc
Đặt tùy chọn theme thành 'dark' hoặc 'light' và tùy chọn cung cấp primaryColor phù hợp với bảng màu công ty. Trình xem tôn trọng các biến CSS, cho phép tùy chỉnh sâu hơn qua stylesheet tùy chỉnh.
4.3 Công cụ dành riêng cho CAD
Nếu bạn đang hiển thị các tệp DWG, DXF hoặc DGN, bật các tùy chọn CAD enableMeasurement và enableLayerToggle. Điều này sẽ thêm các công cụ đo khoảng cách, góc và diện tích cũng như bảng điều khiển hiển thị lớp ngay trong thanh công cụ.
4.4 Địa phương hoá
Cung cấp mã locale (ví dụ, 'fr' cho tiếng Pháp) khi khởi tạo. Tất cả các chuỗi UI, tooltip và thông báo lỗi sẽ được hiển thị bằng ngôn ngữ đã chọn.
Tại sao nên tùy chỉnh? Doconut App cho phép bạn giữ cho trình xem trông như một phần mở rộng tự nhiên của site trong khi vẫn cung cấp trải nghiệm bảo mật, không cần plugin.
5. Kiểm tra Tích hợp trên Tất cả Các Định dạng Được Hỗ trợ
Trước khi đưa vào hoạt động, thực hiện một kiểm tra nhanh cho mỗi loại tệp mà bạn dự kiến người dùng sẽ xem. Sử dụng trình xem của Doconut App, mở một tệp mẫu của mỗi định dạng và xác nhận rằng việc render, điều hướng và bất kỳ công cụ chuyên biệt nào hoạt động như mô tả.
| Định dạng | Kịch bản Kiểm tra | Kết quả Mong đợi |
|---|---|---|
| Báo cáo đa trang lớn có hình ảnh nhúng | Cuộn mượt, thu phóng, màu sắc chính xác | |
| DOCX | Tài liệu Word có bảng và chú thích | Toàn bộ văn bản, bảng, chú thích hiển thị; không dịch chuyển bố cục |
| XLSX | Bảng tính có biểu đồ | Biểu đồ render dưới dạng vector; thu phóng vẫn rõ nét |
| PPTX | Bộ slide có preview tĩnh | Slide đầu tiên hiển thị đúng; không có tài nguyên bị hỏng |
| DWG | Bản vẽ kỹ thuật có nhiều lớp | Có thể bật/tắt lớp, đo lường, các đường nét giữ độ sắc nét |
| PSD | Tệp Photoshop có lớp | Các lớp hiển thị, màu sắc chính xác, thu phóng vẫn sắc nét |
| SVG | Đồ họa vector có gradient | Gradient render mượt; thu phóng vẫn sắc nét |
| TIFF | Ảnh quét độ phân giải cao | Ảnh tải nhanh; thu phóng tiết lộ chi tiết |
Việc chạy qua danh sách kiểm tra này với Doconut App đảm bảo mọi định dạng được hỗ trợ hoạt động ổn định cho người dùng của bạn.
Kết luận
Việc nhúng một trình xem tài liệu bảo mật, không cần plugin giờ đã trở nên đơn giản với Doconut App. Bằng cách làm theo các bước trên — cài đặt SDK, cấu hình tải lên được mã hóa, nhúng widget JavaScript nhẹ, và tùy chỉnh UI — bạn có thể cung cấp việc render tài liệu nhanh, chất lượng cao trên các ứng dụng ASP.NET Core, MVC và WebForms.
Sẵn sàng đánh giá? Bắt đầu với trang tải và tài liệu chính thức của Doconut, sau đó thử nghiệm SDK trong cùng quy trình đánh giá bảo mật được áp dụng cho phần còn lại của ứng dụng ASP.NET dựa trên Windows của bạn.