Sì—puoi incorporare un visualizzatore di file online sicuro e senza plugin in qualsiasi applicazione ASP.NET Core, MVC o WebForms in pochi minuti, e Doconut App si occupa di tutto il lavoro pesante.
Le aziende che gestiscono contratti, disegni o risorse di design hanno bisogno di un visualizzatore che rispetti le politiche di sicurezza aziendali e non costringa mai gli utenti a installare plugin legacy del browser. Doconut fornisce un SDK .NET per visualizzatore di documenti per flussi di lavoro basati su browser per PDF, Office, CAD, email e immagini. Questo post descrive le decisioni di integrazione senza fare affidamento su codice di esempio specifico per versione.
1. Perché la sicurezza e il rendering senza plugin sono importanti per le app web .NET
Le aziende moderne trattano ogni documento come una potenziale perdita di dati. Quando incorpori un visualizzatore che si basa su ActiveX, Flash o un client nativo, erediti tre rischi:
| Rischio | Impatto sulla tua applicazione .NET | Come Doconut App lo elimina |
|---|---|---|
| Dipendenza da plugin | Gli utenti devono installare o abilitare un plugin del browser, generando ticket di supporto e problemi di conformità. | Doconut funziona interamente in HTML5/Canvas, richiedendo zero plugin. |
| Trasferimento non crittografato | I file viaggiano su HTTP o sono memorizzati in testo semplice, violando GDPR, HIPAA o le politiche interne. | Tutti gli upload passano attraverso SSL e sono memorizzati con crittografia AES‑256. |
| Ciclo di vita non controllato | I file possono rimanere sul server, aumentando la superficie di violazione. | Doconut elimina automaticamente i file dopo la visualizzazione, garantendo una finestra di conservazione breve. |
Poiché il visualizzatore è fornito come componente JavaScript che comunica con il servizio di rendering sicuro di Doconut, mantieni lo stack .NET pulito—nessuna libreria nativa aggiuntiva, nessun binario di terze parti e nessun audit di conformità extra.
2. Preparare il progetto .NET
Utilizza il pacchetto, la documentazione e gli esempi che corrispondono alla versione di Doconut selezionata per il progetto. La pagina ufficiale di download di Doconut è il punto di partenza affidabile.
Prima dell'integrazione, conferma il runtime .NET di destinazione, registra la versione del pacchetto, mantieni la configurazione della licenza fuori dal controllo del codice sorgente e inizia con documenti rappresentativi. ASP.NET Core, MVC e WebForms hanno cicli di vita dell'applicazione diversi, quindi la loro configurazione non dovrebbe essere trattata come identica.
3. Creare un endpoint di upload sicuro – AES‑256, SSL e cancellazione automatica
Il visualizzatore non accede mai ai file direttamente sul tuo file system. Invece, carichi il documento in una posizione di archiviazione temporanea e crittografata che Doconut legge su richiesta. Di seguito una descrizione ad alto livello dei passaggi richiesti per ASP.NET Core; le stesse idee si applicano a MVC e WebForms.
Flusso di lavoro lato server
- Accetta il file caricato – Usa lo standard
IFormFile(oHttpPostedFilein WebForms) per ricevere il documento dal client. - Crittografa il file con AES‑256 – Prima di persistere lo stream, crittografilo usando una libreria collaudata come
System.Security.Cryptography.Aes. Memorizza il blob crittografato in una posizione sicura (ad esempio Azure Blob Storage con crittografia lato server abilitata, o un bucket S3 con SSE‑AES256). - Genera un URL firmato a breve durata – Crea un URL valido per pochi minuti (ad esempio 5 minuti). L'URL deve essere HTTPS e includere un token crittografico che Doconut può convalidare. La maggior parte dei provider di cloud storage offre una funzionalità di “URL pre‑firmato” che soddisfa questa esigenza.
- Restituisci l'URL firmato al client – Invia una risposta JSON contenente l'URL. Il client passerà questo URL al visualizzatore Doconut.
- Programma la cancellazione automatica – Dopo la scadenza dell'URL firmato, un job in background (Hangfire, Azure Functions, ecc.) rimuove il blob crittografato, garantendo che il file non rimanga sul server.
Equivalenti MVC / WebForms
- MVC – Inserisci la stessa logica all'interno di un'azione controller regolare e restituisci
JsonResult. - WebForms – Implementa un handler
.ashxo un metodo di pagina che segue gli stessi passaggi: riceviRequest.Files[0], crittografa, genera un URL pre‑firmato e scrivi la risposta JSON.
L'unica differenza è la sintassi di routing; il flusso di sicurezza rimane identico.
4. Renderizzare il documento tramite l'SDK installato
Mantieni l'accesso al documento sul server e applica l'autorizzazione prima di elaborare un file o uno stream. La sequenza esatta di rendering e inizializzazione UI è specifica per versione; segui la documentazione ufficiale fornita con la build installata invece di copiare un'API JavaScript globale non verificata.
Perché questo funziona per ogni variante .NET
- ASP.NET Core Razor – Lo script vive nella stessa view che ospita il modulo di upload, quindi il flusso è fluido.
- MVC – Usa
@section Scriptsper iniettare lo stesso snippet; il controller restituisce JSON che$.ajaxdi MVC può consumare. - WebForms – Registra lo script con
ClientScript.RegisterStartupScriptdopo il completamento dell'upload, poi chiamalaunchViewerallo stesso modo.
Poiché Doconut trasmette il documento direttamente dall'URL firmato, il server non tocca più il file dopo il passaggio di upload. Il visualizzatore rende PDF, file Word, disegni CAD e tutti gli altri formati elencati nelle specifiche del prodotto—senza alcuna conversione aggiuntiva lato server.
5. Personalizzare il visualizzatore per adattarlo al tuo brand – perfezionare il visualizzatore di file online
Le aziende spesso hanno bisogno che il visualizzatore abbia l'aspetto di una parte nativa del loro portale. L'interfaccia completamente personalizzabile di Doconut App ti permette di:
| Personalizzazione | Come applicare in .NET |
|---|---|
| Layout della barra degli strumenti | Passa toolbar: false e costruisci i tuoi pulsanti che chiamano l'API JavaScript del visualizzatore (es., zoomIn(), print()). |
| Schema di colori | Imposta theme: "dark" o fornisci un file CSS personalizzato che sovrascrive le classi predefinite. |
| Lingua e accessibilità | Doconut rispetta l'attributo lang sul contenitore; puoi anche iniettare etichette ARIA tramite l'opzione accessibility. |
| Hook di eventi | Callback come onPageChange, onError e onDownload ti permettono di registrare metriche di utilizzo nel tuo pipeline di telemetria esistente. |
Tutti questi hook sono configurati nello stesso oggetto JavaScript mostrato nella sezione precedente. Poiché il visualizzatore vive interamente sul client, non c'è carico server aggiuntivo—il tuo backend .NET rimane focalizzato su autenticazione, crittografia e logica di business.
6. Prestazioni e scalabilità – mantenere l'esperienza reattiva
Incorporare un visualizzatore in un portale ad alto traffico solleva due preoccupazioni pratiche: tempo di caricamento e rendering concorrente. Doconut App affronta entrambi subito, ma puoi rafforzare le prestazioni con alcuni trucchi specifici per .NET.
| Problema | Vantaggio integrato di Doconut | Suggerimento .NET aggiuntivo |
|---|---|---|
| Download iniziale | Lo script del visualizzatore è solo ~150 KB, gzippato. | Abilita compressione dei file statici (app.UseResponseCompression()) e caching (Cache‑Control: public, max‑age=31536000). |
| Streaming del file | Doconut trasmette solo le pagine necessarie, usando richieste HTTP range. | Memorizza i blob crittografati in un CDN regionale (Azure Front Door, Amazon CloudFront) per ridurre la latenza. |
| Utenti concorrenti | Il rendering avviene sul client; il server serve il file crittografato solo una volta per visualizzazione. | Limita l'endpoint di upload con IApplicationRateLimiter per proteggere da picchi. |
| Impronta di memoria | Nessuna libreria di conversione PDF lato server, quindi il processo ASP.NET rimane leggero. | Esegui il servizio di upload in un microservizio separato se hai già una coda di job di background pesante. |
Seguendo queste linee guida, puoi supportare migliaia di visualizzatori simultanei senza dover scalare il tier web .NET oltre a quanto già possiedi.
Punti chiave
- Doconut App fornisce un visualizzatore senza plugin, 100 % sicuro che funziona con ASP.NET Core, MVC e WebForms.
- Gli upload sono solo SSL, memorizzati con crittografia AES‑256 e cancellati automaticamente dopo la scadenza dell'URL firmato.
- L'integrazione richiede solo uno script CDN, un contenitore
<div>e un piccolo endpoint lato server che restituisce un URL firmato. - Il visualizzatore supporta PDF, Office, CAD e oltre 50 formati immagine—non è necessaria alcuna conversione aggiuntiva lato server.
- L'interfaccia può essere completamente personalizzata per corrispondere al branding aziendale, e il visualizzatore offre zoom, misurazione e strumenti di livello integrati per i file CAD.
- Le prestazioni sono gestite sul lato client; gli sviluppatori .NET devono solo garantire la compressione dei file statici e, opzionalmente, il caching CDN.
- L'intero flusso di lavoro—dall'upload sicuro al rendering nel browser—si integra perfettamente nei pipeline di autenticazione e autorizzazione .NET esistenti.
Domande comuni
D1: Devo installare pacchetti NuGet per usare Doconut?
R: No. Il visualizzatore è fornito come bundle JavaScript lato client dal CDN di Doconut. Il tuo server ha bisogno solo del consueto middleware ASP.NET Core per upload di file e crittografia, che probabilmente hai già.
D2: Come fa Doconut a garantire che il file venga cancellato dopo la visualizzazione?
R: Doconut genera un URL firmato a breve durata che scade dopo un periodo configurabile (tipicamente cinque minuti). Dopo la scadenza dell'URL, tu (o un job di pulizia in background) elimini il blob crittografato. Questo garantisce che il documento non venga conservato più a lungo del necessario, soddisfacendo politiche di conservazione dati rigorose.
D3: Posso usare il visualizzatore per stampare o esportare il documento?
R: Sì. La barra degli strumenti integrata di Doconut include opzioni di stampa ed esportazione che preservano la qualità e il layout originali del file sorgente.
Pronto a incorporare un visualizzatore di documenti sicuro e senza plugin nella tua applicazione .NET? Inizia subito con Doconut App e fornisci PDF, Office, CAD e decine di altri formati in modo sicuro e istantaneo.