Π
7/10/2026

Πώς να ενσωματώσετε έναν προβολέα εγγράφων χωρίς πρόσθετα σε ASP.NET

Οδηγός βήμα‑βήμα για μηχανικούς .NET που χρειάζονται να ενσωματώσουν τον ασφαλή, χωρίς πρόσθετα προβολέα εγγράφων του Doconut App σε έργα ASP.NET Core, MVC ή WebForms.

Ναι—μπορείτε να ενσωματώσετε έναν ασφαλή, χωρίς πρόσθετα online προβολέα αρχείων σε οποιαδήποτε εφαρμογή ASP.NET Core, MVC ή WebForms σε λίγα μόνο λεπτά, και το Doconut App κάνει όλη τη βαριά δουλειά.
Οι επιχειρήσεις που διαχειρίζονται συμβόλαια, σχέδια ή σχεδιαστικά υλικά χρειάζονται έναν προβολέα που σέβεται τις πολιτικές ασφαλείας της εταιρείας, λειτουργεί σε κάθε πρόγραμμα περιήγησης και δεν απαιτεί ποτέ από τους χρήστες να εγκαταστήσουν πρόσθετα τρίτων. Το Doconut App παρέχει ακριβώς αυτό: έναν προβολέα βασισμένο σε πρόγραμμα περιήγησης που υποστηρίζει PDF, Office, CAD και 50+ άλλες μορφές, με κρυπτογράφηση AES‑256, μεταφορτώσεις μόνο μέσω SSL και πλήρως προσαρμόσιμο UI. Αυτό το άρθρο σας καθοδηγεί μέσα από όλη τη ροή εργασίας—από την ασφαλή μεταφόρτωση του αρχείου μέχρι την απόδοση του προβολέα—ώστε να παραδώσετε μια ολοκληρωμένη, επιχειρησιακής κλίμακας λύση χωρίς να γράψετε μηχανή απόδοσης από την αρχή.


1. Γιατί η ασφάλεια και η απόδοση χωρίς πρόσθετα είναι σημαντικές για εφαρμογές web .NET

Οι σύγχρονες επιχειρήσεις θεωρούν κάθε έγγραφο ως πιθανή διαρροή δεδομένων. Όταν ενσωματώνετε έναν προβολέα που βασίζεται σε ActiveX, Flash ή έναν εγγενή πελάτη, κληρονομείτε τρεις κινδύνους:

ΚίνδυνοςΕπίπτωση στην εφαρμογή .NETΠώς το Doconut App το εξαλείφει
Εξάρτηση από πρόσθετοΟι χρήστες πρέπει να εγκαταστήσουν ή να ενεργοποιήσουν ένα πρόσθετο του προγράμματος περιήγησης, οδηγώντας σε αιτήματα υποστήριξης και προβλήματα συμμόρφωσης.Το Doconut λειτουργεί εξ ολοκλήρου σε HTML5/Canvas, απαιτώντας μηδέν πρόσθετα.
Μη κρυπτογραφημένη μετάδοσηΤα αρχεία μεταφέρονται μέσω HTTP ή αποθηκεύονται σε απλό κείμενο, παραβιάζοντας το GDPR, το HIPAA ή τις εσωτερικές πολιτικές.Όλες οι μεταφορτώσεις περνούν μέσω SSL και αποθηκεύονται με κρυπτογράφηση AES‑256.
Ανεξέλεγκτος κύκλος ζωήςΤα αρχεία μπορεί να παραμείνουν στον διακομιστή, αυξάνοντας την έκθεση σε παραβιάσεις.Το Doconut διαγράφει αυτόματα τα αρχεία μετά την προβολή, εξασφαλίζοντας σύντομο παράθυρο διατήρησης.

Επειδή ο προβολέας παρέχεται ως στοιχείο JavaScript που επικοινωνεί με την ασφαλή υπηρεσία απόδοσης του Doconut, διατηρείτε το .NET stack καθαρό—χωρίς επιπλέον εγγενείς βιβλιοθήκες, χωρίς τρίτα δυαδικά αρχεία και χωρίς πρόσθετους ελέγχους συμμόρφωσης.

2. Προετοιμασία του έργου .NET – η ελάχιστη ρύθμιση για ASP.NET Core, MVC και WebForms

Ανεξάρτητα από το αν χρησιμοποιείτε ASP.NET Core, MVC 5 ή WebForms, τα βήματα προετοιμασίας είναι τα ίδια:

  1. Προσθέστε το πακέτο script του Doconut
    Το Doconut φιλοξενεί ένα ελαφρύ script προβολέα στο CDN του. Προσθέστε την παρακάτω γραμμή στη σελίδα διάταξης (π.χ., _Layout.cshtml ή Site.Master):

    <script src="https://doconut.app/viewer.min.js"></script>
    
  2. Δημιουργήστε ένα στοιχείο placeholder
    Ο προβολέας εισάγει ένα καμβά σε οποιοδήποτε <div> ορίσετε. Παράδειγμα για Razor:

    <div id="docViewer" style="width:100%; height:800px;"></div>
    

    Για WebForms, τοποθετήστε ένα <asp:Panel> με runat="server" και δώστε του ID="docViewer".

  3. Αναφέρετε το CSS του Doconut (προαιρετικό)
    Αν θέλετε την προεπιλεγμένη γραμμή εργαλείων και το θέμα, συμπεριλάβετε το αρχείο CSS:

    <link rel="stylesheet" href="https://doconut.app/viewer.min.css" />
    

Αυτά είναι όλα τα στατικά αρχεία που χρειάζεστε. Το υπόλοιπο έργο γίνεται στον κώδικα server‑side (μεταφόρτωση, κρυπτογράφηση, δημιουργία token) και σε ένα μικρό script client‑side αρχικοποίησης.

3. Δημιουργία ασφαλούς endpoint μεταφόρτωσης – AES‑256, SSL και αυτόματη διαγραφή

Ο προβολέας δεν έχει πρόσβαση στα αρχεία απευθείας από το σύστημα αρχείων σας. Αντίθετα, ανεβάζετε το έγγραφο σε προσωρινή, κρυπτογραφημένη τοποθεσία αποθήκευσης που το Doconut διαβάζει κατόπιν αιτήματος. Παρακάτω περιγράφεται υψηλού επιπέδου η διαδικασία για ASP.NET Core· οι ίδιες ιδέες ισχύουν για MVC και WebForms.

Server‑side workflow

  1. Αποδοχή του ανεβασμένου αρχείου – Χρησιμοποιήστε το τυπικό IFormFileHttpPostedFile σε WebForms) για να λάβετε το έγγραφο από τον πελάτη.
  2. Κρυπτογράφηση του αρχείου με AES‑256 – Πριν αποθηκεύσετε το stream, κρυπτογραφήστε το χρησιμοποιώντας μια αξιόπιστη βιβλιοθήκη όπως System.Security.Cryptography.Aes. Αποθηκεύστε το κρυπτογραφημένο blob σε ασφαλή τοποθεσία (π.χ., Azure Blob Storage με ενεργοποιημένη κρυπτογράφηση διακομιστή ή S3 bucket με SSE‑AES256).
  3. Δημιουργία σύντομης υπογεγραμμένης URL – Δημιουργήστε μια διεύθυνση URL που ισχύει για λίγα λεπτά (π.χ., 5 λεπτά). Η URL πρέπει να είναι HTTPS και να περιλαμβάνει ένα κρυπτογραφικό token που μπορεί να επαληθεύσει το Doconut. Οι περισσότεροι πάροχοι cloud προσφέρουν δυνατότητα “pre‑signed URL” που εξυπηρετεί αυτήν την ανάγκη.
  4. Επιστροφή της υπογεγραμμένης URL στον πελάτη – Στείλτε μια απάντηση JSON που περιέχει τη διεύθυνση URL. Ο πελάτης θα παραδώσει αυτήν τη URL στον προβολέα Doconut.
  5. Προγραμματισμός αυτόματης διαγραφής – Μετά τη λήξη της υπογεγραμμένης URL, μια εργασία παρασκηνίου (Hangfire, Azure Functions κ.λπ.) αφαιρεί το κρυπτογραφημένο blob, εξασφαλίζοντας ότι το αρχείο δεν παραμένει στον διακομιστή.

MVC / WebForms equivalents

  • MVC – Τοποθετήστε την ίδια λογική μέσα σε μια κανονική ενέργεια ελεγκτή και επιστρέψτε JsonResult.
  • WebForms – Υλοποιήστε έναν χειριστή .ashx ή μια μέθοδο σελίδας που ακολουθεί τα ίδια βήματα: λήψη Request.Files[0], κρυπτογράφηση, δημιουργία προ-υπογεγραμμένης URL και εγγραφή της απάντησης JSON.

Η μόνη διαφορά είναι η σύνταξη δρομολόγησης· η ροή ασφαλείας παραμένει ταυτοτική.

4. Απόδοση του προβολέα Doconut – από URL σε καμβά στο πρόγραμμα περιήγησης

Μόλις ο πελάτης λάβει τη υπογεγραμμένη URL, ο προβολέας μπορεί να εκκινηθεί με μία κλήση JavaScript. Το SDK του Doconut διαχειρίζεται αυτόματα τη ροή, την απόδοση και τις αλληλεπιδράσεις UI.

<script>
    // Assume `response.viewerUrl` contains the signed URL returned from the upload endpoint
    function launchViewer(viewerUrl) {
        // Initialise the Doconut viewer. The global object provided by the script is `DoconutViewer`.
        DoconutViewer.init({
            containerId: "docViewer",   // The <div> we placed earlier
            fileUrl: viewerUrl,          // Signed, HTTPS URL to the encrypted file
            toolbar: true,               // Show the built‑in toolbar
            theme: "light"              // Optional visual theme
        });
    }

    // Example: after a successful upload
    fetch("/api/document/upload", {
        method: "POST",
        body: myFormData,
        credentials: "include"
    })
    .then(r => r.json())
    .then(data => launchViewer(data.viewerUrl));
</script>

Γιατί λειτουργεί αυτό για κάθε γεύση .NET

  • ASP.NET Core Razor – Το script βρίσκεται στην ίδια προβολή που φιλοξενεί τη φόρμα ανεβάσματος, οπότε η ροή είναι αδιάσπαστη.
  • MVC – Χρησιμοποιήστε @section Scripts για να ενσωματώσετε το ίδιο απόσπασμα· ο ελεγκτής επιστρέφει JSON που μπορεί να καταναλώσει το $.ajax του MVC.
  • WebForms – Καταχωρίστε το script με ClientScript.RegisterStartupScript μετά την ολοκλήρωση του ανεβάσματος, και καλέστε το launchViewer με τον ίδιο τρόπο.

Επειδή το Doconut μεταδίδει το έγγραφο απευθείας από τη υπογεγραμμένη URL, ο διακομιστής δεν αγγίζει ξανά το αρχείο μετά το βήμα ανεβάσματος. Ο προβολέας αποδίδει PDF, Word, CAD και όλες τις άλλες μορφές που αναφέρονται στα χαρακτηριστικά του προϊόντος—χωρίς καμία επιπλέον μετατροπή server‑side.

5. Προσαρμογή του προβολέα ώστε να ταιριάζει με το brand σας – λεπτομερής ρύθμιση του online προβολέα αρχείων

Οι επιχειρήσεις συχνά χρειάζονται ο προβολέας να μοιάζει με ενσωματωμένο μέρος της πύλης τους. Το πλήρως προσαρμόσιμο UI του Doconut App σας επιτρέπει:

ΠροσαρμογήΠώς να το εφαρμόσετε σε .NET
Διάταξη γραμμής εργαλείωνΟρίστε toolbar: false και δημιουργήστε τα δικά σας κουμπιά που καλούν το JavaScript API του προβολέα (π.χ., zoomIn(), print()).
Σχέδιο χρωμάτωνΟρίστε theme: "dark" ή παρέχετε ένα προσαρμοσμένο αρχείο CSS που υπερκαλύπτει τις προεπιλεγμένες κλάσεις.
Γλώσσα & προσβασιμότηταΤο Doconut σέβεται το χαρακτηριστικό lang του container· μπορείτε επίσης να ενσωματώσετε ετικέτες ARIA μέσω της επιλογής accessibility.
Γάντζοι συμβάντωνΤα callbacks όπως onPageChange, onError και onDownload σας επιτρέπουν να καταγράψετε μετρικές χρήσης στο υπάρχον σύστημα τηλεμετρίας.

Όλες αυτές οι παραμετροποιήσεις γίνονται στο ίδιο αντικείμενο JavaScript που φαίνεται στην προηγούμενη ενότητα. Επειδή ο προβολέας ζει εξ ολοκλήρου στην πλευρά του πελάτη, δεν υπάρχει επιπλέον φορτίο στον διακομιστή—το backend .NET παραμένει εστιασμένο στην αυθεντικοποίηση, την κρυπτογράφηση και τη λογική της επιχείρησης.

6. Απόδοση και κλιμακωσιμότητα – διατηρήστε την εμπειρία γρήγορη

Η ενσωμάτωση ενός προβολέα σε μια πύλη υψηλής κίνησης εγείρει δύο πρακτικές ανησυχίες: χρόνος φόρτωσης και συγχρόνια απόδοση. Το Doconut App αντιμετωπίζει και τα δύο αμέσως, αλλά μπορείτε να ενισχύσετε το περιβάλλον απόδοσης με μερικές .NET‑συγκεκριμένες τεχνικές.

ΑνησυχίαΠλεονέκτημα του DoconutΕπιπλέον συμβουλή .NET
Αρχική λήψηΤο script του προβολέα είναι μόνο ~150 KB, gzipped.Ενεργοποιήστε συμπίεση στατικών αρχείων (app.UseResponseCompression()) και caching (Cache‑Control: public, max‑age=31536000).
Ροή αρχείουΤο Doconut μεταδίδει μόνο τις σελίδες που χρειάζονται, χρησιμοποιώντας HTTP range requests.Αποθηκεύστε τα κρυπτογραφημένα blobs σε περιοregional CDN (Azure Front Door, Amazon CloudFront) για μείωση της καθυστέρησης.
Συγχρόνιες χρήστεςΗ απόδοση γίνεται στον πελάτη· ο διακομιστής εξυπηρετεί το κρυπτογραφημένο αρχείο μόνο μία φορά ανά προβολή.Περιορίστε το endpoint ανεβάσματος με IApplicationRateLimiter για προστασία από αιχμές.
Κατανάλωση μνήμηςΔεν υπάρχουν βιβλιοθήκες μετατροπής PDF στον διακομιστή, έτσι η διαδικασία ASP.NET παραμένει ελαφριά.Εκτελέστε την υπηρεσία ανεβάσματος σε ξεχωριστό μικροϋπηρεσία εάν ήδη χρησιμοποιείτε βαριά ουρά εργασιών.

Ακολουθώντας αυτές τις οδηγίες, μπορείτε να υποστηρίξετε χιλιάδες ταυτόχρονους προβολείς χωρίς να χρειάζεται να κλιμακώσετε το .NET web tier πέρα από ό,τι ήδη διαθέτετε.

Key Takeaways

  • Το Doconut App παρέχει έναν χωρίς πρόσθετα, 100 % ασφαλή προβολέα που λειτουργεί με ASP.NET Core, MVC και WebForms.
  • Οι μεταφορτώσεις είναι μόνο μέσω SSL, αποθηκεύονται με κρυπτογράφηση AES‑256, και διαγράφονται αυτόματα μετά τη λήξη της υπογεγραμμένης URL.
  • Η ενσωμάτωση απαιτεί μόνο ένα script CDN, ένα στοιχείο <div> container και ένα μικρό endpoint server‑side που επιστρέφει μια υπογεγραμμένη URL.
  • Ο προβολέας υποστηρίζει PDF, Office, CAD και 50+ μορφές εικόνας—χωρίς ανάγκη μετατροπής server‑side.
  • Το UI μπορεί να προσαρμοστεί πλήρως ώστε να ταιριάζει με το εταιρικό branding, και ο προβολέας προσφέρει ενσωματωμένα εργαλεία ζουμ, μέτρησης και στρώσεων για αρχεία CAD.
  • Η απόδοση διαχειρίζεται στην πλευρά του πελάτη· οι προγραμματιστές .NET χρειάζεται μόνο να εξασφαλίσουν συμπίεση στατικών αρχείων και προαιρετική caching CDN.
  • Η πλήρης ροή εργασίας—από ασφαλή μεταφόρτωση μέχρι απόδοση στο πρόγραμμα περιήγησης—εντάσσεται καθαρά στα υπάρχοντα pipelines ελέγχου ταυτότητας και εξουσιοδότησης .NET.

Common Questions

Q1: Χρειάζεται να εγκαταστήσω κάποιο πακέτο NuGet για να χρησιμοποιήσω το Doconut;
A: Όχι. Ο προβολέας παρέχεται ως πακέτο JavaScript στην πλευρά του πελάτη από το CDN του Doconut. Ο διακομιστής σας χρειάζεται μόνο το συνηθισμένο middleware του ASP.NET Core για μεταφορτώσεις αρχείων και κρυπτογράφηση, το οποίο πιθανότατα έχετε ήδη.

Q2: Πώς εξασφαλίζει το Doconut ότι το αρχείο διαγράφεται μετά την προβολή;
A: Το Doconut δημιουργεί μια σύντομη υπογεγραμμένη URL που λήγει μετά από ένα ρυθμιζόμενο διάστημα (συνήθως πέντε λεπτά). Μετά τη λήξη της URL, εσείς (ή μια εργασία καθαρισμού στο παρασκήνιο) διαγράφετε το κρυπτογραφημένο blob. Αυτό εγγυάται ότι το έγγραφο δεν παραμένει περισσότερο από το απαραίτητο, ικανοποιώντας αυστηρές πολιτικές διατήρησης δεδομένων.

Q3: Μπορώ να χρησιμοποιήσω τον προβολέα για εκτύπωση ή εξαγωγή του εγγράφου;
A: Ναι. Η ενσωματωμένη γραμμή εργαλείων του Doconut περιλαμβάνει επιλογές εκτύπωσης και εξαγωγής που διατηρούν την αρχική ποιότητα και διάταξη του πηγαίου αρχείου.

Ready to embed a secure, zero‑plugin document viewer in your .NET application? Start with Doconut App today and deliver PDF, Office, CAD, and dozens of other formats safely and instantly.