Sí—puede incrustar un visor de archivos en línea seguro y sin complementos en cualquier aplicación ASP.NET Core, MVC o WebForms en solo unos minutos, y Doconut App hace todo el trabajo pesado.
Las empresas que manejan contratos, planos o activos de diseño necesitan un visor que respete las políticas de seguridad corporativas y nunca obligue a los usuarios a instalar complementos de navegador heredados. Doconut ofrece un SDK de visor de documentos .NET para flujos de trabajo basados en navegador con PDF, Office, CAD, correo electrónico e imágenes. Esta publicación describe las decisiones de integración sin depender de código de muestra específico de versión.
1. Por qué la seguridad y el renderizado sin complementos son importantes para aplicaciones web .NET
Las empresas modernas tratan cada documento como una posible fuga de datos. Cuando incrusta un visor que depende de ActiveX, Flash o un cliente nativo, hereda tres riesgos:
| Riesgo | Impacto en su aplicación .NET | Cómo lo elimina Doconut App |
|---|---|---|
| Dependencia de complementos | Los usuarios deben instalar o habilitar un complemento del navegador, lo que genera tickets de soporte y problemas de cumplimiento. | Doconut se ejecuta completamente en HTML5/Canvas, sin requerir ningún complemento. |
| Tránsito sin cifrar | Los archivos viajan por HTTP o se almacenan en texto plano, violando GDPR, HIPAA o políticas internas. | Todas las cargas pasan por SSL y se almacenan con cifrado AES‑256. |
| Ciclo de vida no controlado | Los archivos pueden permanecer en el servidor, aumentando la superficie de vulnerabilidad. | Doconut elimina automáticamente los archivos después de la visualización, garantizando una ventana de retención corta. |
Dado que el visor se entrega como un componente JavaScript que se comunica con el servicio de renderizado seguro de Doconut, mantiene la pila .NET limpia—sin bibliotecas nativas adicionales, sin binarios de terceros y sin auditorías de cumplimiento extra.
2. Prepare el proyecto .NET
Utilice el paquete, la documentación y los ejemplos que coincidan con la versión de Doconut seleccionada para el proyecto. La página oficial de descarga de Doconut es el punto de partida fiable.
Antes de la integración, confirme el runtime .NET objetivo, registre la versión del paquete, mantenga la configuración de licencia fuera del control de versiones y comience con documentos representativos. ASP.NET Core, MVC y WebForms tienen ciclos de vida de aplicación diferentes, por lo que su configuración no debe tratarse como idéntica.
3. Construir un punto final de carga segura – AES‑256, SSL y eliminación automática
El visor nunca accede a los archivos directamente en su sistema de archivos. En su lugar, carga el documento a una ubicación de almacenamiento temporal y cifrada que Doconut lee bajo demanda. A continuación se muestra una descripción de alto nivel de los pasos requeridos para ASP.NET Core; las mismas ideas se aplican a MVC y WebForms.
Flujo de trabajo del lado del servidor
- Aceptar el archivo cargado – Utilice el estándar
IFormFile(oHttpPostedFileen WebForms) para recibir el documento del cliente. - Cifrar el archivo con AES‑256 – Antes de persistir el flujo, encriptelo usando una biblioteca probada como
System.Security.Cryptography.Aes. Almacene el blob cifrado en una ubicación segura (p. ej., Azure Blob Storage con cifrado del lado del servidor habilitado, o un bucket S3 con SSE‑AES256). - Generar una URL firmada de corta duración – Cree una URL válida por unos minutos (p. ej., 5 minutos). La URL debe ser HTTPS e incluir un token criptográfico que Doconut pueda validar. La mayoría de los proveedores de almacenamiento en la nube ofrecen una función de “URL pre‑firmada” que cubre esta necesidad.
- Devolver la URL firmada al cliente – Envíe una respuesta JSON que contenga la URL. El cliente entregará esta URL al visor de Doconut.
- Programar la eliminación automática – Después de que la URL firmada expire, un trabajo en segundo plano (Hangfire, Azure Functions, etc.) elimina el blob cifrado, garantizando que el archivo no permanezca en el servidor.
Equivalentes en MVC / WebForms
- MVC – Coloque la misma lógica dentro de una acción de controlador regular y devuelva
JsonResult. - WebForms – Implemente un controlador
.ashxo un método de página que siga los mismos pasos: recibirRequest.Files[0], cifrar, generar una URL pre‑firmada y escribir la respuesta JSON.
La única diferencia es la sintaxis de enrutamiento; el flujo de trabajo de seguridad sigue siendo idéntico.
4. Renderizar el documento mediante el SDK instalado
Mantenga el acceso al documento en el servidor y haga cumplir la autorización antes de procesar un archivo o flujo. La secuencia exacta de renderizado e inicialización de la UI depende de la versión; siga la documentación oficial incluida con la compilación instalada en lugar de copiar una API JavaScript global no verificada.
Por qué esto funciona para cualquier variante .NET
- ASP.NET Core Razor – El script vive en la misma vista que aloja el formulario de carga, por lo que el flujo es continuo.
- MVC – Use
@section Scriptspara inyectar el mismo fragmento; el controlador devuelve JSON que$.ajaxde MVC puede consumir. - WebForms – Registre el script con
ClientScript.RegisterStartupScriptdespués de que la carga se complete, luego llame alaunchViewerde la misma manera.
Dado que Doconut transmite el documento directamente desde la URL firmada, el servidor no vuelve a tocar el archivo después del paso de carga. El visor renderiza PDFs, archivos Word, dibujos CAD y todos los demás formatos enumerados en los datos del producto—sin ninguna conversión adicional del lado del servidor.
5. Personalizar el visor para que coincida con su marca – afinar el visor de archivos en línea
Las empresas a menudo necesitan que el visor se vea como una parte nativa de su portal. La UI totalmente personalizable de Doconut App le permite:
| Personalización | Cómo aplicarlo en .NET |
|---|---|
| Diseño de barra de herramientas | Pase toolbar: false y cree sus propios botones que llamen a la API JavaScript del visor (p. ej., zoomIn(), print()). |
| Esquema de colores | Establezca theme: "dark" o proporcione un archivo CSS personalizado que sobrescriba las clases predeterminadas. |
| Idioma y accesibilidad | Doconut respeta el atributo lang en el contenedor; también puede inyectar etiquetas ARIA mediante la opción accessibility. |
| Ganchos de eventos | Los callbacks como onPageChange, onError y onDownload le permiten registrar métricas de uso en su canal de telemetría existente. |
Todos estos ganchos se configuran en el mismo objeto JavaScript mostrado en la sección anterior. Dado que el visor vive completamente en el cliente, no hay carga adicional del servidor—su backend .NET sigue centrado en la autenticación, el cifrado y la lógica de negocio.
6. Rendimiento y escalabilidad – mantenga la experiencia ágil
Incrustar un visor en un portal de alto tráfico plantea dos preocupaciones prácticas: tiempo de carga y renderizado concurrente. Doconut App aborda ambos de forma nativa, pero puede reforzar el rendimiento con algunos trucos específicos de .NET.
| Preocupación | Ventaja incorporada de Doconut | Consejo adicional para .NET |
|---|---|---|
| Descarga inicial | El script del visor es solo ~150 KB, comprimido con gzip. | Habilite compresión de archivos estáticos (app.UseResponseCompression()) y caché (Cache‑Control: public, max‑age=31536000). |
| Transmisión de archivos | Doconut transmite solo las páginas necesarias, usando solicitudes de rango HTTP. | Almacene los blobs cifrados en una CDN regional (Azure Front Door, Amazon CloudFront) para reducir la latencia. |
| Usuarios concurrentes | El renderizado ocurre en el cliente; el servidor solo sirve el archivo cifrado una vez por vista. | Regule el punto final de carga con IApplicationRateLimiter para protegerse de picos. |
| Huella de memoria | Sin bibliotecas de conversión PDF del lado del servidor, por lo que el proceso ASP.NET se mantiene ligero. | Ejecute el servicio de carga en un microservicio separado si ya tiene una cola de trabajos en segundo plano pesada. |
Siguiendo estas directrices, puede soportar miles de visores simultáneos sin escalar la capa web .NET más allá de lo que ya tiene.
Conclusiones clave
- Doconut App ofrece un visor sin complementos y 100 % seguro que funciona con ASP.NET Core, MVC y WebForms.
- Las cargas son solo SSL, se almacenan con cifrado AES‑256 y se eliminan automáticamente después de que la URL firmada expire.
- La integración requiere solo un script CDN, un contenedor
<div>y un pequeño punto final del lado del servidor que devuelva una URL firmada. - El visor admite PDF, Office, CAD y más de 50 formatos de imagen—no se necesita conversión del lado del servidor.
- La UI puede ser totalmente personalizada para coincidir con la marca corporativa, y el visor ofrece herramientas integradas de zoom, medición y capas para archivos CAD.
- El rendimiento se maneja del lado del cliente; los desarrolladores .NET solo necesitan garantizar la compresión de archivos estáticos y el almacenamiento en caché opcional mediante CDN.
- Todo el flujo de trabajo—desde la carga segura hasta el renderizado en el navegador—se integra limpiamente en los pipelines de autenticación y autorización .NET existentes.
Preguntas comunes
Q1: ¿Necesito instalar paquetes NuGet para usar Doconut?
A: No. El visor se entrega como un paquete JavaScript del lado del cliente desde el CDN de Doconut. Su servidor solo necesita el middleware habitual de ASP.NET Core para cargas de archivos y cifrado, que probablemente ya tenga.
Q2: ¿Cómo garantiza Doconut que el archivo se elimine después de la visualización?
A: Doconut genera una URL firmada de corta duración que expira después de un período configurable (comúnmente cinco minutos). Después de que la URL expire, usted (o un trabajo de limpieza en segundo plano) elimina el blob cifrado. Esto garantiza que el documento no se retenga más tiempo del necesario, cumpliendo con políticas estrictas de retención de datos.
Q3: ¿Puedo usar el visor para imprimir o exportar el documento?
A: Sí. La barra de herramientas integrada de Doconut incluye opciones de impresión y exportación que preservan la calidad y el diseño original del archivo fuente.
¿Listo para incrustar un visor de documentos seguro y sin complementos en su aplicación .NET? Comience con Doconut App hoy y entregue PDF, Office, CAD y docenas de otros formatos de forma segura e instantánea.