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

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

Ασφαλής αποθήκευση εγγράφων συνδεδεμένη με ενσωματωμένο προβολέα σε .NET web εφαρμογή

Γιατί ένας ενσωματωμένος προβολέας διαφέρει από τη λήψη αρχείου

Ένα σημείο λήψης μεταφέρει το αρχικό αρχείο και αφήνει την εμπειρία προβολής σε λογισμικό εκτός της εφαρμογής σας. Ένας ενσωματωμένος προβολέας διατηρεί τον χρήστη μέσα στο προϊόν σας και μπορεί να προσφέρει ένα συνεπές σημείο για πλοήγηση, αναζήτηση, ανασκόπηση και άλλες ενεργοποιημένες λειτουργίες.

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

Τα αρχεία PDF μπορούν να περιέχουν ενσωματωμένες γραμματοσειρές, σημειώσεις, φόρμες και πολύ μεγάλα σύνολα σελίδων.
Τα αρχεία Word, Excel και PowerPoint απαιτούν προσεκτική διάταξη και διαχείριση γραμματοσειρών.
Τα σχέδια CAD χρειάζονται ακριβή κλιμάκωση, στρώματα και λεπτομερή ζουμ.
Τα φορμά email και εικόνας εισάγουν συνημμένα, μεταδεδομένα, χρώμα και ζητήματα ανάλυσης.

Ένα εξειδικευμένο SDK επιτρέπει στην ομάδα της εφαρμογής να εστιάσει στον έλεγχο πρόσβασης, στις ροές εργασίας και στην εμπειρία χρήστη, αντί να συντηρεί ξεχωριστό renderer για κάθε υποστηριζόμενη μορφή.

Βήμα 1: Επιβεβαίωση των απαιτούμενων μορφών και λειτουργιών

Ξεκινήστε με ένα πραγματικό απόθεμα των αρχείων που ανοίγουν οι χρήστες σας. Διαχωρίστε τις βασικές μορφές από τις περιστασιακές και καταγράψτε αντιπροσωπευτικά δείγματα για δοκιμές.

Η λίστα ελέγχου σας μπορεί να περιλαμβάνει:

Έγγραφα PDF και XPS
Έγγραφα επεξεργασίας κειμένου
Φύλλα εργασίας
Παρουσιάσεις
Σχέδια CAD
Αρχεία email
Συνηθισμένες μορφές εικόνας

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

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

Βήμα 2: Επιλογή του σημείου εισόδου των εγγράφων στην εφαρμογή

Μια εφαρμογή ASP.NET μπορεί να λαμβάνει έγγραφα από πολλές ελεγχόμενες πηγές:

Μια μεταφόρτωση που διαχειρίζεται το ASP.NET Core IFormFile
Μια προστατευμένη τοποθεσία αρχείων
Μια βάση δεδομένων ή αποθετήριο διαχείρισης εγγράφων
Αποθήκευση αντικειμένων προσβάσιμη από τον διακομιστή
Μια εσωτερική υπηρεσία που επιστρέφει ένα Stream

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

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

Βήμα 3: Ορισμός Εξουσιοδότησης και Ελέγχου Πρόσβασης

Η εφαρμογή — όχι το UI του προβολέα — πρέπει να αποφασίζει ποιος μπορεί να ανοίξει ένα έγγραφο.

Στο ASP.NET Core, τυπικοί μηχανισμοί όπως το middleware ελέγχου ταυτότητας, το χαρακτηριστικό [Authorize], οι πολιτικές, τα claims και η εξουσιοδότηση βάσει πόρων μπορούν να προστατεύσουν το σημείο λήψης που εκκινεί μια συνεδρία προβολής. Η απόφαση εξουσιοδότησης πρέπει να λαμβάνει υπόψη τόσο τον τρέχοντα χρήστη όσο και το ζητούμενο έγγραφο.

Μια ασφαλής ροή αιτήματος φαίνεται ως εξής:

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

Ποτέ μην υποθέτετε ότι η απόκρυψη ενός κουμπιού εργαλειοθήκης αποτελεί έλεγχο εξουσιοδότησης. Οι ελέγχοι πρόσβασης στο διακομιστή παραμένουν απαραίτητοι ακόμη και όταν δεν εμφανίζονται έλεγχοι λήψης ή εκτύπωσης.

Βήμα 4: Προσθήκη Doconut μέσω των Επίσημων Πόρων Ενσωμάτωσης

Χρησιμοποιήστε το τρέχον πακέτο και τις οδηγίες εγκατάστασης που παρέχονται από το Doconut. Η επαληθευμένη σελίδα λήψης Doconut παρέχει πρόσβαση σε πόρους ενσωμάτωσης NuGet, τεκμηρίωση, παραδείγματα και demos.

Η ακριβής ρύθμιση μπορεί να εξαρτάται από:

Τον τύπο της εφαρμογής ASP.NET ή .NET
Το επιλεγμένο προϊόν και τα plugins του Doconut
Την έκδοση του Doconut
Την άδειά σας
Τις μορφές εγγράφων και τις λειτουργίες που ενεργοποιείτε
Τις ρυθμίσεις του Windows server σας

Ακολουθήστε την τεκμηρίωση που ταιριάζει με την εγκατεστημένη έκδοση. Αποφύγετε την αντιγραφή αποσπασμάτων αρχικοποίησης από ανεξάρτητα blog posts, επειδή τα namespaces, οι ρυθμίσεις, οι διαδρομές πόρων και τα APIs μπορεί να αλλάξουν μεταξύ εκδόσεων.

Βήμα 5: Δημιουργία Αφιερωμένου Ορίου Προβολής

Κρατήστε την προβολή εγγράφων πίσω από μια μικρή υπηρεσία εφαρμογής αντί να καλείτε τη λειτουργικότητα του SDK σε πολλούς ελεγκτές και UI στοιχεία.

Αυτή η υπηρεσία μπορεί να είναι υπεύθυνη για:

Εντοπισμό ενός εξουσιοδοτημένου αναγνωριστικού εγγράφου
Άνοιγμα του εγγράφου ως ελεγχόμενο Stream όταν είναι κατάλληλο
Παροχή απαιτούμενης διαμόρφωσης προβολής
Απελευθέρωση πόρων αρχείου και ροής
Μετατροπή τεχνικών αποτυχιών σε ασφαλή σφάλματα εφαρμογής
Καταγραφή λειτουργικών μετρήσεων χωρίς καταγραφή του περιεχομένου του εγγράφου

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

Βήμα 6: Σχεδίαση της Σελίδας Προβολέα

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

Σχεδιάστε τη σελίδα γύρω από:

Σταθερό ύψος προβολέα
Καθαρές καταστάσεις φόρτωσης, κενής και σφάλματος
Συνοπτικό τίτλο εγγράφου
Ελέγχους προσβάσιμους με πληκτρολόγιο γύρω από τον προβολέα
Διάταξη που δεν κρύβει σημαντικούς ελέγχους του προβολέα
Έναν σαφή τρόπο επιστροφής στην γονική ροή εργασίας

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

Βήμα 7: Διαχείριση Αρχείων και Προσωρινών Δεδομένων

Ορίστε μια πολιτική διατήρησης πριν από την ανάπτυξη. Θεωρήστε ξεχωριστά το αρχικό αρχείο, τα προσωρινά δεδομένα απόδοσης, τις προσωρινές μνήμες, τις εξαγωγές, τις σημειώσεις και τα αρχεία καταγραφής.

Χρήσιμα μέτρα προστασίας περιλαμβάνουν:

Έναν αφιερωμένο προσωρινό φάκελο με περιορισμένα δικαιώματα
Μοναδικά ονόματα που δημιουργεί ο διακομιστής
Καθαρισμό μετά από ολοκληρωμένες και αποτυχημένες συνεδρίες
Μια προγραμματισμένη διαδικασία για εγκαταλελειμμένα προσωρινά αρχεία
Ποσοστώσεις αποθήκευσης και παρακολούθηση
Κρυπτογράφηση κατά την αποθήκευση όπου απαιτείται από την πολιτική ασφαλείας σας

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

Βήμα 8: Διαμόρφωση Παραγωγικών Μέτρων Ασφαλείας

Η απόδοση εγγράφων μπορεί να καταναλώσει CPU, μνήμη και προσωρινό χώρο δίσκου. Προστατέψτε την εφαρμογή με σαφή όρια:

Μέγιστο μέγεθος μεταφόρτωσης
Μέγιστος αριθμός ταυτόχρονων εργασιών απόδοσης
Χρονικά όρια αιτήματος και επεξεργασίας
Όρια ουράς όταν η απόδοση εκτελείται ασύγχρονα
Ποσοστώσεις προσωρινής αποθήκευσης
Ελέγχους υγείας και δομημένη παρακολούθηση σφαλμάτων

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

Βήμα 9: Δοκιμή Ολόκληρης της Ροής Εργασίας

Μια επιτυχημένη δοκιμή ενσωμάτωσης πρέπει να καλύπτει περισσότερα από το «εμφανίστηκε η πρώτη σελίδα».

Δοκιμάστε:

Κάθε απαιτούμενη μορφή αρχείου
Μικρά, μεγάλα, πολυσέλιδα και κατεστραμμένα αρχεία
Έγγραφα με ασυνήθιστες γραμματοσειρές
Αρχεία προστατευμένα με κωδικό όταν η ροή σας τα υποστηρίζει
Εξουσιοδοτημένους και μη εξουσιοδοτημένους χρήστες
Ταυτόχρονες συνεδρίες προβολής
Επανεκκινήσεις εφαρμογής και διακοπές αιτημάτων
Καθαρισμό μετά από επιτυχία και αποτυχία
Λειτουργίες προβολέα που περιλαμβάνονται στη διαμόρφωση του επιλεγμένου προϊόντος

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

Λίστα Ελέγχου Ασφαλείας

Πριν την κυκλοφορία, βεβαιωθείτε ότι:

Κάθε αίτημα προβολής απαιτεί έλεγχο ταυτότητας όπου είναι απαραίτητο.
Η εξουσιοδότηση ελέγχεται για το συγκεκριμένο έγγραφο.
Η είσοδος που ελέγχεται από τον χρήστη δεν μπορεί να γίνει ανεξέλεγκτη διαδρομή αρχείου στον διακομιστή.
Τα διαπιστευτήρια αποθήκευσης δεν φτάνουν ποτέ στον πελάτη.
Οι περιορισμοί μεταφόρτωσης και η επικύρωση είναι ενεργοποιημένα.
Τα προσωρινά αρχεία έχουν περιορισμένη πρόσβαση και δοκιμασμένη πολιτική καθαρισμού.
Τα αρχεία καταγραφής δεν περιέχουν περιεχόμενο εγγράφων, μυστικά ή ευαίσθητα URLs.
Τα μηνύματα σφάλματος που εμφανίζονται στους χρήστες είναι αποκατεστημένα.
Τα στοιχεία του SDK και της εφαρμογής ακολουθούν διαδικασία ενημέρωσης.

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

Πού Τοποθετείται το Doconut

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

Αυτή η κατανομή ευθυνών δίνει στις ομάδες .NET έναν πρακτικό δρόμο για την υποστήριξη επιχειρηματικών εγγράφων χωρίς την ανάγκη δημιουργίας πολλαπλών μηχανών απόδοσης από την αρχή. Επίσης διατηρεί τις λεπτομέρειες ενσωμάτωσης συνδεδεμένες με την επίσημη τεκμηρίωση της έκδοσης που αναπτύσσετε.

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

Συμπέρασμα

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

Με αυτές τις βάσεις, το Doconut μπορεί να παρέχει το επίπεδο προβολής για την Windows‑based .NET web εφαρμογή σας, ενώ η ομάδα σας διατηρεί τον έλεγχο της αρχιτεκτονικής της εφαρμογής και του κύκλου ζωής των εγγράφων.