Πολλοί προγραμματιστές ξεκινούν αναζητώντας βιβλιοθήκες στοιχείων διεπαφής χρήστη όταν χρειάζεται να εμφανίσουν έγγραφα σε μια διαδικτυακή εφαρμογή. Doconut Viewer είναι ένα .NET SDK για προσθήκη προβολής χωρίς plugin στον περιηγητή σε έργα ASP.NET Core, MVC ή κλασικά WebForms. Η ασφάλεια εξακολουθεί να εξαρτάται από τη συνολική αρχιτεκτονική της εφαρμογής: ταυτοποίηση, εξουσιοδότηση, μεταφορά, αποθήκευση, επικύρωση, καθαρισμό, ενημερώσεις και παρακολούθηση.

Ασφαλής προβολέας εγγράφων ASP.NET προστατευμένος από στρωτικούς ελέγχους εφαρμογής

1. Εγκατάσταση του Doconut App SDK και Προετοιμασία του .NET Project σας για Πολλαπλές Μορφές Αρχείων

1.1 Προσθήκη του υποστηριζόμενου πακέτου

Χρησιμοποιήστε το τρέχον πακέτο και τις οδηγίες εγκατάστασης από τη σελίδα λήψης του Doconut. Καταγράψτε την επιλεγμένη έκδοση και βεβαιωθείτε ότι υποστηρίζει το στοχευόμενο .NET runtime.

1.2 Επαλήθευση της αναφοράς του πακέτου

Μετά την εγκατάσταση, επιβεβαιώστε την αναφορά του πακέτου και την επιλυμένη έκδοση στο αρχείο του έργου. Η ρητή διαχείριση εκδόσεων βοηθά να γίνουν οι κατασκευές και οι αναπτύξεις επαναλήψιμες.

1.3 Ενεργοποίηση HTTPS

Το Doconut App απαιτεί SSL για όλες τις μεταφορτώσεις αρχείων. Βεβαιωθείτε ότι η εφαρμογή σας ακούει σε HTTPS. Για μια εφαρμογή που φιλοξενείται από Kestrel, προσθέστε μια διαμόρφωση endpoint στο appsettings.json:

{
  "Kestrel": {
    "Endpoints": {
      "Https": {
        "Url": "
      }
    }
  }
}

Αν φιλοξενείτε σε IIS, συνδέστε ένα πιστοποιητικό HTTPS στον ιστότοπο. Με το HTTPS ενεργό, κάθε αρχείο ταξιδεύει μέσω ασφαλούς καναλιού πριν φτάσει στη μηχανή απόδοσης του Doconut App.

Γιατί Doconut App;
Το Doconut App είναι ο μοναδικός .NET‑native προβολέας που συνδυάζει μηδενική χρήση plugin με κρυπτογράφηση AES‑256 από άκρη σε άκρη, επιτρέποντάς σας να τηρείτε απαιτήσεις συμμόρφωσης χωρίς πρόσθετη υποδομή.

2. Διαμόρφωση Ασφαλών Μεταφορτώσεων Αρχείων και Αποθήκευσης για Διαχείριση Εγγράφων

Το μοντέλο ασφαλείας του Doconut App βασίζεται σε τρία θεμέλια: μεταφορά SSL, κρυπτογράφηση AES‑256 κατά την αποθήκευση και αυτόματη διαγραφή μετά την προβολή. Το SDK παρέχει μια έτοιμη υπηρεσία που μπορείτε να καταχωρίσετε στην εφαρμογή σας.

2.1 Καταχώρηση της υπηρεσίας μεταφόρτωσης

Στο Startup.cs (ή Program.cs για .NET 6+), προσθέστε τις υπηρεσίες Doconut στο container εξάρτησης. Διαμορφώστε έναν προσωρινό φάκελο αποθήκευσης, ενεργοποιήστε την κρυπτογράφηση AES‑256 και ορίστε το διάστημα αυτόματης διαγραφής (π.χ., 10 λεπτά μετά την προβολή του εγγράφου).

2.2 Δημιουργία του σημείου μεταφόρτωσης

Υλοποιήστε μια ενέργεια ελεγκτή που λαμβάνει ένα μεταφορτωμένο αρχείο, το περνά στην υπηρεσία Doconut για ασφαλή αποθήκευση και επιστρέφει ένα σύντομο διακριτικό μίας χρήσης. Το διακριτικό είναι αυτό που θα χρησιμοποιήσει ο προβολέας στην πλευρά του πελάτη για να ανακτήσει και να αποδώσει το έγγραφο.

2.3 Προστασία του σημείου

Επειδή το σημείο μεταφόρτωσης διαχειρίζεται ευαίσθητα δεδομένα, προστατέψτε το με ταυτοποίηση και εξουσιοδότηση βάσει ρόλου (π.χ., μόνο χρήστες με ρόλο DocumentViewer μπορούν να ανεβάσουν). Αυτό εξασφαλίζει ότι μόνο εξουσιοδοτημένο προσωπικό μπορεί να αποθηκεύσει και να προβάλλει εμπιστευτικά έγγραφα.

Πλεονέκτημα Doconut App: Το SDK διαχειρίζεται κρυπτογράφηση και καθαρισμό για εσάς, ώστε να μην χρειάζεται ποτέ να γράψετε κώδικα κρυπτογραφίας ή να ανησυχείτε για ορφανά αρχεία.

3. Ενσωμάτωση του Συστατικού Προβολέα σε ASP.NET Core, MVC ή WebForms

Με την πλευρά διακομιστή έτοιμη, αρχικοποιήστε τον προβολέα χρησιμοποιώντας τα assets και το API που τεκμηριώνονται για την εγκατεστημένη έκδοση Doconut.

3.1 Προσθήκη της συλλογής JavaScript

Στο κοινό layout, συμπεριλάβετε μόνο τους πόρους του προβολέα που περιγράφονται στην τεκμηρίωση που ταιριάζει με το εγκατεστημένο SDK. Μην υποθέτετε σταθερά ονόματα ή τοποθεσίες συλλογών μεταξύ εκδόσεων.

3.2 Δημιουργία Razor άποψης για Core/MVC

Προσθέστε μια άποψη (π.χ., Views/Document/View.cshtml) που περιέχει ένα πεδίο επιλογής αρχείου, ένα στοιχείο container για τον προβολέα και ένα μικρό σενάριο που ανεβάζει το επιλεγμένο αρχείο, λαμβάνει το ασφαλές διακριτικό και αρχικοποιεί το συστατικό Doconut Viewer.

Το σενάριο πρέπει:

Να συλλάβει το επιλεγμένο αρχείο από το στοιχείο <input type="file">.
Να στείλει το αρχείο στο σημείο μεταφόρτωσης χρησιμοποιώντας fetch ή XMLHttpRequest.
Όταν φτάσει η εξουσιοδοτημένη απάντηση, να αρχικοποιήσει τον προβολέα με το υποστηριζόμενο API για την εγκατεστημένη έκδοση.

3.3 Ισοδύναμο για WebForms

Σε μια σελίδα WebForms (π.χ., DocumentViewer.aspx), τοποθετήστε έναν έλεγχο asp:FileUpload, ένα κουμπί για την έναρξη της μεταφόρτωσης και ένα <div> που θα φιλοξενήσει τον προβολέα. Στον κώδικα‑πίσω, καλέστε την υπηρεσία Doconut για αποθήκευση του αρχείου, λάβετε το διακριτικό και εγγράψτε ένα σενάριο εκκίνησης που καλεί τη JavaScript συνάρτηση (initViewer(token)) για δημιουργία του προβολέα.

Οφέλη Doconut App: Ένα μόνο συστατικό JavaScript, τρία μοντέλα UI .NET, μηδενικές επιπλέον βιβλιοθήκες. Απλότητα στο έπακρο.

4. Προσαρμογή του Προβολέα για Διαχείριση Εγγράφων

Από την αρχή, ο Doconut Viewer προσφέρει μια καθαρή γραμμή εργαλείων, ελέγχους ζουμ και εναλλαγή φωτεινού/σκοτεινού θέματος. Μπορείτε να προσαρμόσετε το UI ώστε να ταιριάζει με το brand σας και με συγκεκριμένους τύπους εγγράφων.

4.1 Διαμόρφωση γραμμής εργαλείων

Κατά την αρχικοποίηση του προβολέα, μπορείτε να ορίσετε ποια στοιχεία της γραμμής εργαλείων θα είναι ορατά (π.χ., download, print, zoomIn, zoomOut, fullScreen). Η αφαίρεση του κουμπιού download, για παράδειγμα, εμποδίζει τους χρήστες να αποθηκεύσουν το αρχικό αρχείο.

4.2 Θέμα και χρώματα

Ορίστε την επιλογή theme σε 'dark' ή 'light' και προαιρετικά δώστε ένα primaryColor που ευθυγραμμίζεται με την εταιρική σας παλέτα. Ο προβολέας σέβεται τις CSS μεταβλητές, επιτρέποντας πιο βαθιά στυλιζάρισμα μέσω προσαρμοσμένου stylesheet.

4.3 Εργαλεία ειδικά για CAD

Αν προβάλλετε αρχεία DWG, DXF ή DGN, ενεργοποιήστε τις επιλογές CAD enableMeasurement και enableLayerToggle. Αυτό προσθέτει εργαλεία μέτρησης απόστασης, γωνίας και εμβαδού καθώς και πίνακα ορατότητας επιπέδων απευθείας στη γραμμή εργαλείων.

4.4 Τοπικοποίηση

Περάστε έναν κωδικό locale (π.χ., 'fr' για γαλλικά) κατά την αρχικοποίηση. Όλες οι συμβολοσειρές UI, τα tooltip και τα μηνύματα σφάλματος θα εμφανιστούν στην επιλεγμένη γλώσσα.

Γιατί η προσαρμογή; Το Doconut App σας επιτρέπει να διατηρήσετε τον προβολέα ως φυσική επέκταση του site σας, ενώ συνεχίζετε να προσφέρετε την ίδια ασφαλή, χωρίς plugin εμπειρία.

5. Δοκιμή της Ενσωμάτωσης σε Όλες τις Υποστηριζόμενες Μορφές

Πριν το λανσάρετε, εκτελέστε έναν γρήγορο έλεγχο λογικής για κάθε τύπο αρχείου που αναμένετε να προβάλλουν οι χρήστες σας. Χρησιμοποιώντας τον προβολέα Doconut App, ανοίξτε ένα δείγμα αρχείου για κάθε μορφή και επαληθεύστε ότι η απόδοση, η πλοήγηση και τυχόν εξειδικευμένα εργαλεία λειτουργούν όπως περιγράφεται.

Μορφή	Σενάριο Δοκιμής	Αναμενόμενο Αποτέλεσμα
PDF	Μεγάλη, πολυσελίδα αναφορά με ενσωματωμένες εικόνες	Ομαλή κύλιση, ζουμ και ακριβής απόδοση χρωμάτων
DOCX	Έγγραφο Word με πίνακες και υποσημειώσεις	Όλο το κείμενο, οι πίνακες και οι υποσημειώσεις εμφανίζονται· χωρίς μετατόπιση διάταξης
XLSX	Φύλλο εργασίας με γραφήματα	Τα γραφήματα αποδίδονται ως διανυσματικά· το ζουμ διατηρεί την ευκρίνεια
PPTX	Παρουσίαση με στατική προεπισκόπηση	Η πρώτη διαφάνεια εμφανίζεται σωστά· χωρίς σπασμένα στοιχεία
DWG	Τεχνικό σχέδιο με πολλαπλά επίπεδα	Εναλλαγή επιπέδων, λειτουργούν οι μετρήσεις, οι γραμμές παραμένουν καθαρές
PSD	Αρχείο Photoshop με επίπεδα	Τα επίπεδα είναι ορατά, τα χρώματα ακριβή, το ζουμ παραμένει οξύ
SVG	Διανυσματικό γραφικό με διαβαθμίσεις	Οι διαβαθμίσεις αποδίδονται ομαλά· το ζουμ παραμένει οξύ
TIFF	Σάρωση υψηλής ανάλυσης	Η εικόνα φορτώνεται γρήγορα· το ζουμ αποκαλύπτει λεπτομέρειες

Η διέλευση αυτής της λίστας ελέγχου με το Doconut App εξασφαλίζει ότι κάθε υποστηριζόμενη μορφή συμπεριφέρεται αξιόπιστα για τους χρήστες σας.

Συμπέρασμα

Η ενσωμάτωση ενός ασφαλούς, χωρίς plugin προβολέα εγγράφων είναι πλέον απλή με το Doconut App. Ακολουθώντας τα παραπάνω βήματα—εγκατάσταση του SDK, διαμόρφωση κρυπτογραφημένων μεταφορτώσεων, ενσωμάτωση του ελαφρού συστατικού JavaScript και προσαρμογή του UI—μπορείτε να προσφέρετε γρήγορη, υψηλής ποιότητας απόδοση εγγράφων σε εφαρμογές ASP.NET Core, MVC και WebForms.

Έτοιμοι να το δοκιμάσετε; Ξεκινήστε από τη σελίδα λήψης και τεκμηρίωσης του Doconut (σελίδα λήψης και τεκμηρίωσης του Doconut), έπειτα δοκιμάστε το SDK μέσα στην ίδια αξιολόγηση ασφαλείας που εφαρμόζετε στο υπόλοιπο Windows‑based ASP.NET περιβάλλον σας.