Συνεδρίες & Ασφάλεια
Συνεδρίες εγγράφων και έλεγχος πρόσβασης
Ένα διακριτικό Doconut είναι ισχυρό: όποιος το παρουσιάζει θα μπορούσε να ζητήσει κάθε σελίδα του εγγράφου αν δεν ήταν δεσμευμένο στη συνεδρία ανοίγματος. Αυτή η σελίδα εξηγεί τι περιέχει μια συνεδρία, πόσο διαρκεί και τους ελέγχους που ενεργοποιεί από προεπιλογή το UseDoconut().
Τι περιέχει μια συνεδρία εγγράφου
Κάθε επιτυχής OpenDocumentAsync δημιουργεί μία συνεδρία στο IMemoryCache:
- το φορτωμένος προβολέας μορφής (η παρουσία του μηχανήματος εγγράφου που κρατά το αναλυμένο έγγραφο),
- κατάσταση ανά σελίδα — περιστροφή, αναστροφές και δεδομένα σχολίων που ο χρήστης εφαρμόζει στο widget,
- ο προαιρετικός δείκτης αναζήτησης, που δημιουργείται αργά στην πρώτη αναζήτηση (ή φορτώνεται από ένα προ‑κατασκευασμένο αρχείο
.srhόταν οι σελίδες εξυπηρετούνται από κοινόχρηστη αποθήκευση), - το υδατογράφημα της συνεδρίας από
DocOptions.Watermark.
Διάρκεια ζωής
Οι συνεδρίες λήγουν σε ένα παράθυρο κυλιόμενης διάρκειας: DocOptions.TimeOut λεπτά (προεπιλογή 60), που επαναρυθμίζεται από κάθε αίτημα που παρουσιάζει το διακριτικό. Όταν μια συνεδρία αποβάλλεται — λόγω λήξης ή από CloseDocument(token) — η κλήση επιστροφής αποβολής διαγράφει τη μηχανή εγγράφου και ελευθερώνει τη σχετική μνήμη αμέσως.
// Μια βραχύβια συνεδρία για μια εφάπαξ προεπισκόπηση
var token = await viewer.OpenDocumentAsync(path, new DocOptions { TimeOut = 10 });Ένα αίτημα με ληγμένο διακριτικό λαμβάνει μια εικόνα σφάλματος που διαβάζει Document session not found. Please re-open document. — ο πελάτης πρέπει να ανοίξει ξανά για να αποκτήσει ένα νέο διακριτικό.
Ενσωματωμένη δέσμευση διακριτικού
Με το UnsafeMode = false (η προεπιλογή), το OpenDocumentAsync δεσμεύει το νέο διακριτικό στη συνεδρία ASP.NET του HTTP αιτήματος που το άνοιξε, γράφοντας έναν δείκτη secure-{token} σε αυτή τη συνεδρία. Το middleware Doconut τότε αρνείται να εξυπηρετήσει σελίδες σε οποιαδήποτε άλλη συνεδρία προγράμματος περιήγησης:
- Διαφορετικό πρόγραμμα περιήγησης/συνεδρία που παρουσιάζει κλεμμένο διακριτικό → εικόνα σφάλματος
You Are Not Authorized To View This Page. - Middleware συνεδρίας δεν είναι καταχωρημένο → HTTP 500
Session middleware not configured. Call UseSession() before UseDoconut().
Αυτός είναι ο λόγος που το Quick Start επιμένει στο AddSession() + app.UseSession() πριν από το κλάδο Doconut. Δύο πρακτικές συνέπειες:
- Ο πελάτης πρέπει να στέλνει το cookie συνεδρίας ASP.NET με τα αιτήματα σελίδας. Ρυθμίσεις cross‑origin που αφαιρούν cookies (ή ένας πελάτης API χωρίς κουτί cookies) θα αποτύχουν τον έλεγχο — αυτό είναι η λειτουργία του χαρακτηριστικού, όχι σφάλμα.
- Το
options.UnsafeMode = trueαπενεργοποιεί πλήρως τη δέσμευση. Υπάρχει για ελεγχόμενα σενάρια (π.χ. απόδοση server‑to‑server); αφήστε τοfalseστην παραγωγή.
Η δέσμευση διακριτικού ελέγχεται αποκλειστικά από αυτόν τον παγκόσμιο διακόπτη UnsafeMode — είναι ενεργοποιημένο από προεπιλογή (UnsafeMode = false) και εφαρμόζεται σε κάθε συνεδρία. Δεν υπάρχει εξαίρεση ανά έγγραφο· η ρύθμιση UnsafeMode = true απενεργοποιεί τη δέσμευση παγκοσμίως.
Δικαιώματα πρόσβασης και πιστοποιημένοι χρήστες
Όταν το UnsafeMode είναι false, το UseDoconut() εισάγει το DocumentAccessMiddleware αυτόματα πριν από το middleware σελίδας. Μην το καταχωρίσετε δεύτερη φορά. Όταν ένα αίτημα μεταφέρει ένα διακριτικό, αναζητά το δικαίωμα πρόσβασης που καταγράφηκε όταν το έγγραφο ανοίχτηκε και εξουσιοδοτεί μόνο εάν ισχύουν όλα τα παρακάτω:
- υπάρχει δικαίωμα για το διακριτικό,
- δεν έχει λήξει (διάρκεια δικαιώματος = το
TimeOutτου εγγράφου), - το ID της αιτούσας συνεδρίας ASP.NET ταιριάζει με αυτό που άνοιξε το έγγραφο,
- αν ο ανοίγων ήταν πιστοποιημένος, η αξίωση
NameIdentifierτου αιτούσας χρήστη ταιριάζει επίσης.
Οι αποτυχίες επιστρέφουν 403 — ως εικόνα σφάλματος PNG για αιτήματα σελίδας/μικρογραφίας, ως απλό κείμενο διαφορετικά. Το μήνυμα και το κλειδί ερωτήματος διακριτικού προέρχονται από το DocumentSecurityOptions (TokenQueryKey, προεπιλογή "token"; UnauthorizedMessage, προεπιλογή "You Are Not Authorized To View This Page."). Διαμορφώστε αυτές τις επιλογές μέσω ASP.NET Core DI πριν δημιουργήσετε την εφαρμογή. Εάν η κατάσταση συνεδρίας δεν είναι διαθέσιμη, το middleware αποτυγχάνει κλεισμένο με HTTP 500: ASP.NET Session is required for Doconut document security.
builder.Services.Configure<Doconut.Security.DocumentSecurityOptions>(options =>
{
options.TokenQueryKey = "token";
options.UnauthorizedMessage = "You Are Not Authorized To View This Page.";
});Το βασικό middleware σελίδας στη συνέχεια επαληθεύει τον δείκτη συνεδρίας secure-{token} πριν εξυπηρετήσει το έγγραφο. Με το UnsafeMode = true, το UseDoconut() παραλείπει το middleware πρόσβασης και ο έλεγχος του βασικού δείκτη είναι επίσης απενεργοποιημένος.
Ασφάλεια σε πολλαπλούς κόμβους
Τα διακριτικά δεσμευμένα σε συνεδρία υποθέτουν ότι ο κόμβος που εξυπηρετεί μια σελίδα είδε επίσης το αίτημα που άνοιξε το έγγραφο. Αυτή η υπόθεση δεν ισχύει όταν πολλοί κόμβοι εξυπηρετούν τα ίδια έγγραφα από κοινόχρηστη αποθήκευση: ένα αίτημα σελίδας μπορεί να φτάσει σε κόμβο που δεν είδε ποτέ το άνοιγμα, και ο έλεγχος ανά συνεδρία το απορρίπτει.
Η λύση δεν είναι να αφήνουμε τα έγγραφα απροστάτευτα. Χρησιμοποιήστε υπογεγραμμένα εισιτήρια πρόσβασης μέσω
AddDoconutDistributedDocumentSecurity(...), που αντικαθιστούν τον έλεγχο συνεδρίας με ένα
διαπιστευτήριο που κάθε κόμβος μπορεί να επαληθεύσει ανεξάρτητα. Η πλήρης διάταξη βρίσκεται στο
Διανεμημένες Αναπτύξεις.
Ανάκληση
Το CloseDocument(token) δεν απλώς ελευθερώνει μνήμη — αφαιρεί επίσης τον δείκτη secure-{token} και ανακαλεί το δικαίωμα πρόσβασης, έτσι ένα κλειστό διακριτικό είναι άμεσο θάνατο και στα δύο επίπεδα ασφαλείας.
Λίστα ελέγχου για παραγωγή
- Διατηρήστε το
UnsafeMode = false(η προεπιλογή) σε έναν μόνο κόμβο — αυτός ο παγκόσμιος διακόπτης είναι αυτός που δεσμεύει τα διακριτικά στις συνεδρίες. - Καταχωρίστε το
AddDistributedMemoryCache()(οι εφαρμογές MVC και Razor Pages το έχουν ήδη) και τοAddSession(), και καλέστε τοapp.UseSession()πριν από τον κλάδο middleware Doconut. - Βεβαιωθείτε ότι η πολιτική cookie συνεδρίας σας επιτρέπει στα αιτήματα του widget να μεταφέρουν το cookie (
SameSite, HTTPS). - Χρησιμοποιήστε το
CloseDocumentόταν ο χρήστης αφήνει το έγγραφο — η μνήμη και η ασφάλεια ωφελούνται. - Ποτέ μην καταγράφετε ή μοιράζεστε διακριτικά· αντιμετωπίζετε τα ως βραχυπρόθεσμα διαπιστευτήρια.
- Εξυπηρετείτε από κοινόχρηστη αποθήκευση; Μεταβείτε σε υπογεγραμμένα εισιτήρια πρόσβασης αντί να αποδέχεστε απροστάτευτα έγγραφα.
Ήταν αυτή η σελίδα χρήσιμη;