Molti sviluppatori iniziano cercando librerie di componenti UI quando hanno bisogno di visualizzare documenti in un'applicazione web. Doconut Visualizzatore è un SDK .NET per aggiungere la visualizzazione nel browser senza plugin a progetti ASP.NET Core, MVC o WebForms classici. La sicurezza dipende comunque dall'architettura completa dell'applicazione: autenticazione, autorizzazione, trasporto, archiviazione, validazione, pulizia, patching e monitoraggio.
1. Installa l'SDK Doconut App e prepara il tuo progetto .NET per più formati di file
1.1 Aggiungi il pacchetto supportato
Utilizza il pacchetto corrente e le istruzioni di configurazione dalla pagina ufficiale di download di Doconut. Registra la versione scelta e verifica che supporti il runtime .NET di destinazione.
1.2 Verifica il riferimento al pacchetto
Dopo l'installazione, conferma il riferimento al pacchetto e la versione risolta nel file di progetto. Mantenere le versioni esplicite aiuta a rendere le compilazioni e le distribuzioni riproducibili.
1.3 Abilita HTTPS
Doconut App richiede SSL per tutti gli upload di file. Assicurati che la tua applicazione ascolti su HTTPS. Per un'app ospitata su Kestrel, aggiungi una configurazione dell'endpoint in appsettings.json:
{
"Kestrel": {
"Endpoints": {
"Https": {
"Url": "
}
}
}
}
Se ospiti su IIS, associa un certificato HTTPS al sito. Con HTTPS abilitato, ogni file viaggia su un canale sicuro prima di raggiungere il motore di rendering di Doconut App.
Perché Doconut App?
Doconut App è l'unico visualizzatore nativo .NET che combina il rendering senza plugin con la crittografia end‑to‑end AES‑256, consentendoti di soddisfare i requisiti di conformità senza aggiungere infrastrutture extra.
2. Configura upload di file sicuri e archiviazione per la gestione dei documenti
Il modello di sicurezza di Doconut App si basa su tre pilastri: trasporto SSL, crittografia AES‑256 a riposo e cancellazione automatica dopo la visualizzazione. L'SDK fornisce un servizio pronto all'uso che puoi registrare nella tua applicazione.
2.1 Registra il servizio di upload
In Startup.cs (o Program.cs per .NET 6+), aggiungi i servizi Doconut al contenitore di iniezione delle dipendenze. Configura una cartella di archiviazione temporanea, abilita la crittografia AES‑256 e imposta l'intervallo di cancellazione automatica (ad esempio, 10 minuti dopo che il documento è stato visualizzato).
2.2 Crea l'endpoint di upload
Implementa un'azione del controller che riceve un file caricato, lo passa al servizio Doconut per l'archiviazione sicura e restituisce un token monouso breve. Il token è ciò che il visualizzatore lato client utilizzerà per recuperare e rendere il documento.
2.3 Proteggi l'endpoint
Poiché l'endpoint di upload gestisce dati sensibili, proteggilo con autenticazione e autorizzazione basata sui ruoli (ad esempio, solo gli utenti con il ruolo DocumentViewer possono caricare). Questo garantisce che solo il personale autorizzato possa archiviare e visualizzare documenti riservati.
Vantaggio di Doconut App: L'SDK gestisce la crittografia e la pulizia per te, così non dovrai mai scrivere codice crittografico personalizzato o preoccuparti di file orfani.
3. Integra il componente Viewer in ASP.NET Core, MVC o WebForms
Con il backend pronto, inizializza il visualizzatore usando le risorse e l'API documentate per la versione Doconut installata.
3.1 Aggiungi il bundle JavaScript
Nel tuo layout condiviso, includi solo le risorse del visualizzatore descritte nella documentazione corrispondente all'SDK installato. Non dare per scontato nomi di bundle o percorsi fissi tra le versioni.
3.2 Crea una vista Razor per Core/MVC
Aggiungi una vista (ad esempio, Views/Document/View.cshtml) che contiene un input file, un elemento contenitore per il visualizzatore e un piccolo script che carica il file selezionato, riceve il token sicuro e inizializza il widget Doconut Viewer.
Lo script dovrebbe:
- Cattura il file selezionato dall'elemento
<input type="file">. - Invia il file all'endpoint di upload usando
fetchoXMLHttpRequest. - Quando arriva la risposta autorizzata, inizializza il visualizzatore usando l'API supportata per la versione installata.
3.3 Equivalente WebForms
In una pagina WebForms (ad esempio, DocumentViewer.aspx), inserisci un controllo asp:FileUpload, un pulsante per avviare l'upload e un <div> che ospiterà il visualizzatore. Nel code‑behind, chiama il servizio Doconut per archiviare il file caricato, ottieni il token e registra uno script di avvio che chiama una funzione JavaScript (initViewer(token)) per creare l'istanza del visualizzatore.
Vantaggio di Doconut App: Un widget JavaScript, tre modelli UI .NET, zero librerie aggiuntive. Semplicità al massimo.
4. Personalizza il visualizzatore per la gestione dei documenti
Di default, Doconut Viewer offre una barra degli strumenti pulita, controlli di zoom e un interruttore tema chiaro/scuro. Puoi personalizzare l'interfaccia per adattarla al tuo brand e a tipi di documento specifici.
4.1 Configurazione della barra degli strumenti
Durante l'inizializzazione del visualizzatore, puoi specificare quali elementi della barra degli strumenti devono essere visibili (ad esempio, download, print, zoomIn, zoomOut, fullScreen). Rimuovere il pulsante download, per esempio, impedisce agli utenti di salvare il file originale.
4.2 Tema e colori
Imposta l'opzione theme su 'dark' o 'light' e, facoltativamente, fornisci un primaryColor che si allinea alla tua palette aziendale. Il visualizzatore rispetta le variabili CSS, consentendo una stilizzazione più profonda tramite un foglio di stile personalizzato.
4.3 Strumenti specifici per CAD
Se visualizzi file DWG, DXF o DGN, abilita le opzioni CAD enableMeasurement e enableLayerToggle. Questo aggiunge strumenti di misurazione di distanza, angolo e area, oltre a un pannello di visibilità dei layer direttamente nella barra degli strumenti.
4.4 Localizzazione
Passa un codice locale (ad esempio, 'fr' per il francese) durante l'inizializzazione. Tutte le stringhe UI, i tooltip e i messaggi di errore saranno mostrati nella lingua selezionata.
Perché personalizzare? Doconut App ti consente di mantenere il visualizzatore come un'estensione naturale del tuo sito, offrendo comunque la stessa esperienza sicura e senza plugin.
5. Testa l'integrazione su tutti i formati supportati
Prima di andare in produzione, esegui un rapido controllo di coerenza per ogni tipo di file che ti aspetti gli utenti visualizzino. Utilizzando il visualizzatore di Doconut App, apri un file di esempio per ciascun formato e verifica che il rendering, la navigazione e gli eventuali strumenti specializzati funzionino come descritto.
| Formato | Scenario di test | Risultato atteso |
|---|---|---|
| Report grande, multipagina con immagini incorporate | Scorrimento fluido, zoom e resa accurata dei colori | |
| DOCX | Documento Word con tabelle e note a piè di pagina | Tutto il testo, le tabelle e le note a piè di pagina sono visibili; nessuno spostamento del layout |
| XLSX | Foglio di calcolo con grafici | I grafici vengono renderizzati come grafica vettoriale; lo zoom mantiene la nitidezza |
| PPTX | Presentazione con anteprima statica | La prima diapositiva viene visualizzata correttamente; nessuna risorsa rotta |
| DWG | Disegno tecnico con più layer | I layer possono essere attivati/disattivati, le misurazioni funzionano, le linee rimangono nitide |
| PSD | File Photoshop con layer | I layer sono visibili, i colori esatti, lo zoom rimane nitido |
| SVG | Grafica vettoriale con gradienti | I gradienti vengono renderizzati senza problemi; lo zoom rimane nitido |
| TIFF | Scansione ad alta risoluzione | L'immagine si carica rapidamente; lo zoom rivela i dettagli |
Conclusione
Integrare un visualizzatore di documenti sicuro e senza plugin è ora semplice con Doconut App. Seguendo i passaggi sopra—installazione dell'SDK, configurazione degli upload crittografati, integrazione del widget JavaScript leggero e personalizzazione dell'interfaccia—puoi offrire una resa rapida e di alta qualità dei documenti su applicazioni ASP.NET Core, MVC e WebForms.
Pronto a valutarlo? Inizia con la pagina ufficiale di download e documentazione di Doconut, poi testa l'SDK all'interno della stessa revisione di sicurezza applicata al resto della tua applicazione ASP.NET basata su Windows.