Muchos desarrolladores comienzan buscando bibliotecas de componentes UI cuando necesitan mostrar documentos en una aplicación web. Visor Doconut es un SDK .NET para añadir visualización en el navegador sin plugins a proyectos ASP.NET Core, MVC o WebForms clásicos. La seguridad sigue dependiendo de la arquitectura completa de la aplicación: autenticación, autorización, transporte, almacenamiento, validación, limpieza, parcheo y monitoreo.
1. Instalar el SDK de Doconut App y preparar su proyecto .NET para múltiples formatos de archivo
1.1 Añadir el paquete compatible
Utilice el paquete actual y las instrucciones de configuración de la página oficial de descarga de Doconut. Registre la versión elegida y verifique que sea compatible con el runtime .NET objetivo.
1.2 Verificar la referencia del paquete
Después de la instalación, confirme la referencia del paquete y la versión resuelta en el archivo del proyecto. Mantener las versiones explícitas ayuda a que las compilaciones y despliegues sean reproducibles.
1.3 Habilitar HTTPS
Doconut App requiere SSL para todas las cargas de archivos. Asegúrese de que su aplicación escuche en HTTPS. Para una aplicación alojada en Kestrel, añada una configuración de endpoint en appsettings.json:
{
"Kestrel": {
"Endpoints": {
"Https": {
"Url": "
}
}
}
}
Si aloja en IIS, vincule un certificado HTTPS al sitio. Con HTTPS habilitado, cada archivo viaja por un canal seguro antes de llegar al motor de renderizado de Doconut App.
¿Por qué Doconut App? Doconut App es el único visor nativo .NET que combina renderizado sin plugins con cifrado AES‑256 de extremo a extremo, permitiéndole cumplir con los requisitos de cumplimiento sin añadir infraestructura adicional.
2. Configurar cargas de archivos seguras y almacenamiento para la gestión de documentos
El modelo de seguridad de Doconut App se basa en tres pilares: transporte SSL, cifrado AES‑256 en reposo y eliminación automática después de la visualización. El SDK proporciona un servicio listo para usar que puede registrar en su aplicación.
2.1 Registrar el servicio de carga
En Startup.cs (o Program.cs para .NET 6+), añada los servicios de Doconut al contenedor de inyección de dependencias. Configure una carpeta de almacenamiento temporal, habilite el cifrado AES‑256 y establezca el intervalo de eliminación automática (por ejemplo, 10 minutos después de que el documento haya sido visualizado).
2.2 Crear el endpoint de carga
Implemente una acción de controlador que reciba un archivo cargado, lo pase al servicio Doconut para almacenamiento seguro y devuelva un token de un solo uso y corto. El token es lo que el visor del lado del cliente utilizará para obtener y renderizar el documento.
2.3 Proteger el endpoint
Debido a que el endpoint de carga maneja datos sensibles, protégalo con autenticación y autorización basada en roles (p. ej., solo los usuarios con el rol DocumentViewer pueden cargar). Esto garantiza que solo el personal autorizado pueda almacenar y ver documentos confidenciales.
Ventaja de Doconut App: El SDK maneja el cifrado y la limpieza por usted, por lo que nunca tendrá que escribir código criptográfico personalizado ni preocuparse por archivos huérfanos.
3. Incrustar el componente del visor en ASP.NET Core, MVC o WebForms
Con el backend listo, inicialice el visor usando los recursos y la API documentados para la versión de Doconut instalada.
3.1 Añadir el paquete JavaScript
En su diseño compartido, incluya solo los recursos del visor descritos en la documentación que coincida con el SDK instalado. No asuma nombres de paquetes o ubicaciones fijas entre versiones.
3.2 Crear una vista Razor para Core/MVC
Añada una vista (p. ej., Views/Document/View.cshtml) que contenga un input de archivo, un elemento contenedor para el visor y un pequeño script que cargue el archivo seleccionado, reciba el token seguro e inicialice el widget Doconut Viewer.
El script debe:
- Capturar el archivo seleccionado del elemento
<input type="file">. - Enviar el archivo al endpoint de carga usando
fetchoXMLHttpRequest. - Cuando llegue la respuesta autorizada, inicializar el visor usando la API compatible con la versión instalada.
3.3 Equivalente para WebForms
En una página WebForms (p. ej., DocumentViewer.aspx), coloque un control asp:FileUpload, un botón para iniciar la carga y un <div> que alojará el visor. En el código subyacente, llame al servicio Doconut para almacenar el archivo cargado, obtener el token y registrar un script de inicio que llame a una función JavaScript (initViewer(token)) para crear la instancia del visor.
Beneficio de Doconut App: Un widget JavaScript, tres modelos UI .NET, cero bibliotecas adicionales. Simplicidad en su máxima expresión.
4. Personalizar el visor para la gestión de documentos
De fábrica, Doconut Viewer ofrece una barra de herramientas limpia, controles de zoom y un conmutador de tema claro/oscuro. Puede adaptar la interfaz para que coincida con su marca y se ajuste a tipos de documentos específicos.
4.1 Configuración de la barra de herramientas
Al inicializar el visor, puede especificar qué elementos de la barra de herramientas deben ser visibles (p. ej., download, print, zoomIn, zoomOut, fullScreen). Eliminar el botón download, por ejemplo, impide que los usuarios guarden el archivo original.
4.2 Tema y colores
Establezca la opción theme a 'dark' o 'light' y, opcionalmente, proporcione un primaryColor que se alinee con la paleta corporativa. El visor respeta las variables CSS, permitiendo una personalización más profunda mediante una hoja de estilo personalizada.
4.3 Herramientas específicas para CAD
Si está mostrando archivos DWG, DXF o DGN, habilite las opciones CAD enableMeasurement y enableLayerToggle. Esto agrega herramientas de medición de distancia, ángulo y área, así como un panel de visibilidad de capas directamente en la barra de herramientas.
4.4 Localización
Pase un código locale (p. ej., 'fr' para francés) durante la inicialización. Todas las cadenas de la UI, descripciones emergentes y mensajes de error se mostrarán en el idioma seleccionado.
¿Por qué personalizar? Doconut App le permite mantener el visor con una apariencia que parece una extensión natural de su sitio, al tiempo que ofrece la misma experiencia segura y sin plugins.
5. Probar la integración en todos los formatos compatibles
Antes de lanzar, realice una rápida comprobación de sanidad para cada tipo de archivo que espere que sus usuarios visualicen. Usando el visor de Doconut App, abra un archivo de muestra de cada formato y verifique que el renderizado, la navegación y cualquier herramienta especializada funcionen como se describe.
| Formato | Escenario de prueba | Resultado esperado |
|---|---|---|
| Informe grande de varias páginas con imágenes incrustadas | Desplazamiento suave, zoom y renderizado de color preciso | |
| DOCX | Documento Word con tablas y notas al pie | Todo el texto, tablas y notas al pie visibles; sin desplazamiento de diseño |
| XLSX | Hoja de cálculo con gráficos | Los gráficos se renderizan como gráficos vectoriales; el zoom mantiene la claridad |
| PPTX | Presentación de diapositivas con vista previa estática | La primera diapositiva se muestra correctamente; sin recursos rotos |
| DWG | Dibujo técnico con múltiples capas | Conmutación de capas, mediciones funcionan, las líneas permanecen nítidas |
| PSD | Archivo Photoshop con capas | Capas visibles, colores exactos, el zoom se mantiene nítido |
| SVG | Gráfica vectorial con degradados | Los degradados se renderizan suavemente; el zoom se mantiene nítido |
| TIFF | Escaneo de alta resolución | La imagen carga rápidamente; el zoom revela detalles |
Recorrer esta lista de verificación con Doconut App garantiza que cada formato compatible se comporte de manera fiable para sus usuarios.
Conclusión
Incrustar un visor de documentos seguro y sin plugins ahora es sencillo con Doconut App. Siguiendo los pasos anteriores —instalar el SDK, configurar cargas cifradas, incrustar el widget JavaScript ligero y personalizar la UI— puede ofrecer renderizado de documentos rápido y de alta calidad en aplicaciones ASP.NET Core, MVC y WebForms.
¿Listo para evaluarlo? Comience con la página oficial de descarga y documentación de Doconut, luego pruebe el SDK dentro de la misma revisión de seguridad aplicada al resto de su aplicación ASP.NET basada en Windows.