Συνεδρίες & Ασφάλεια
Συνεδρίες εγγράφων και έλεγχος πρόσβασης
Ένα Doconut token ταυτοποιεί ένα ανοικτό έγγραφο. Εάν εξυπηρετηθεί οποιοδήποτε αίτημα που το μεταφέρει, όποιος το απέκτησε θα μπορούσε να διαβάσει κάθε σελίδα. Αυτή η σελίδα εξηγεί τι περιέχει μια συνεδρία εγγράφου, πόσο διαρκεί και πώς το DocImage.axd αποφασίζει ποιος μπορεί να δει τις σελίδες του — σε έναν διακομιστή και σε ένα farm web.
Τι περιέχει μια συνεδρία εγγράφου
Κάθε επιτυχημένο OpenDocumentAsync δημιουργεί μία συνεδρία, η οποία διατηρείται στη μνήμη:
- ο φορτωμένος προβολέας μορφής — η παρουσία της μηχανής που κρατά το αναλυμένο έγγραφο,
- κατάσταση ανά σελίδα — περιστροφή, αναστροφές και τα δεδομένα σχολίων που ο χρήστης εφαρμόζει στο widget,
- το προαιρετικό ευρετήριο αναζήτησης, δημιουργείται στην πρώτη αναζήτηση (ή φορτώνεται από ένα προ-κατασκευασμένο αρχείο
.srh), - το υδατογράφημα της συνεδρίας από
DocOptions.Watermark.
Διάρκεια
Οι συνεδρίες λήγουν σε ένα κυλιόμενο παράθυρο: DocOptions.TimeOut λεπτά (προεπιλογή 60), επαναφέρονται από κάθε αίτημα που παρουσιάζει το token. Όταν μια συνεδρία λήγει — λόγω λήξης ή λόγω CloseDocument(token) — η μηχανή του εγγράφου απελευθερώνεται και η μνήμη της ελευθερώνεται αμέσως.
// Μια βραχυπρόθεσμη συνεδρία για μια εφάπαξ προεπισκόπηση
var token = await viewer.OpenDocumentAsync(path, new DocOptions { TimeOut = 10 });Ένα αίτημα με ληγμένο token λαμβάνει μια εικόνα σφάλματος που διαβάζει Document session not found. Please re-open document.. Η σελίδα πρέπει να ανοίξει ξανά το έγγραφο για να πάρει νέο token. Σε έναν μοναδικό διακομιστή, η ανακύκλωση του application pool τερματίζει επίσης κάθε συνεδρία.
Οι σελίδες εξυπηρετούνται μόνο στη συνεδρία που τις άνοιξε
Με το UnsafeMode = false — η προεπιλογή — το άνοιγμα ενός εγγράφου χορηγεί πρόσβαση στη συνεδρία ASP.NET του αιτήματος που το άνοιξε, γράφοντας μια καταχώρηση secure-{token} σε αυτή τη συνεδρία. Το DocImage.axd απαιτεί την ίδια κατάσταση συνεδρίας, και εξυπηρετεί μια σελίδα μόνο όταν η συνεδρία που κάνει το αίτημα κατέχει αυτήν την καταχώρηση. Οποιοσδήποτε άλλος περιηγητής που παρουσιάζει το ίδιο token λαμβάνει μια εικόνα σφάλματος που διαβάζει You Are Not Authorized To View This Page..
Doconut.DoconutHost.Initialize(options =>
{
// false (η προεπιλογή): το DocImage.axd εξυπηρετεί μια σελίδα μόνο στη συνεδρία ASP.NET που την άνοιξε
// το έγγραφο. Ο handler ζητά το session state ο ίδιος· χρειάζεται μόνο το site να μην
// απενεργοποιήσετε το session state στο Web.config.
options.UnsafeMode = false;
});Τρία πρακτικά συμπεράσματα:
- Το σημείο ανοίγματος χρειάζεται κατάσταση συνεδρίας. Οι ελεγκτές MVC και οι σελίδες Web Forms το διαθέτουν από προεπιλογή. Ένα προσαρμοσμένο
IHttpHandlerδεν το διαθέτει εκτός εάν υλοποιείSystem.Web.SessionState.IRequiresSessionState. Ένα άνοιγμα που εκτελείται χωρίς συνεδρία δεν έχει τίποτα να χορηγήσει, έτσι ο προβολέας εμφανίζει «Δεν Είστε Εξουσιοδοτημένοι Να Δείτε Αυτή Τη Σελίδα» σε κάθε σελίδα. - Η κατάσταση συνεδρίας πρέπει να παραμείνει ενεργή. Το
<sessionState mode="Off" />στοWeb.configαπενεργοποιεί τόσο τη χορήγηση όσο και τον έλεγχο, και κάθε σελίδα απορρίπτεται. - Ο περιηγητής πρέπει να στέλνει το cookie συνεδρίας. Τα αιτήματα του widget είναι ίδια προέλευση, έτσι μεταφέρουν το
ASP.NET_SessionIdαυτόματα. Ένας πελάτης χωρίς cookie jar — ένα script, μια κλήση server-to-server, μια ρύθμιση διαφορετικής προέλευσης που αφαιρεί τα cookies — απορρίπτεται. Αυτό είναι το χαρακτηριστικό που λειτουργεί.
UnsafeMode = true απενεργοποιεί τον έλεγχο: οποιοδήποτε αίτημα που μεταφέρει το token εξυπηρετείται. Είναι ένας καθολικός διακόπτης για κάθε έγγραφο, χωρίς δυνατότητα παρακάμψης ανά έγγραφο. Αφήστε το false.
Ανάκληση
CloseDocument(token) κάνει περισσότερα από το να ελευθερώσει μνήμη: αφαιρεί την καταχώρηση secure-{token} από τη συνεδρία του τρέχοντος αιτήματος και ανακαλεί το token, έτσι ένα κλειστό token απορρίπτεται αμέσως.
Web farms: υπογεγραμμένα εισιτήρια
Σε ένα farm, το επόμενο αίτημα μπορεί να καταλήξει σε έναν διακομιστή που δεν έχει δει ποτέ το έγγραφο, σε διαφορετική διεργασία worker, με τη δική του συνεδρία ASP.NET. Η χορήγηση της συνεδρίας δεν μπορεί να το ακολουθήσει. Η κατανεμημένη λειτουργία την αντικαθιστά με ένα υπογεγραμμένο εισιτήριο δεσμευμένο στον περιηγητή: κάθε κόμβος μοιράζεται ένα αποθηκευτικό χώρο για τις συνεδρίες εγγράφων και ένα κλειδί υπογραφής, και το DocImage.axd δέχεται ένα αίτημα όταν το εισιτήριό του είναι έγκυρο για εκείνο το token, εκείνο τον περιηγητή, και — όταν ο χρήστης είναι συνδεδεμένος — εκείνο τον χρήστη.
Η ρύθμιση, ίδια σε κάθε κόμβο:
// Global.asax.cs - Application_Start
// Το μυστικό του farm: τουλάχιστον 32 byte, το ίδιο σε κάθε κόμβο, διατηρείται εκτός ελέγχου έκδοσης.
byte[] farmKey = Convert.FromBase64String(Environment.GetEnvironmentVariable("DOCONUT_FARM_KEY"));
Doconut.DoconutHost.Initialize(
options => options.UnsafeMode = false, // ο έλεγχος του ticket εκτελείται μόνο όταν αυτό είναι false
services => services.AddDoconutDistributed(d =>
{
d.Store = CloudLocation.FileShare;
d.FileShareRootPath = @"\\fileserver\doconut-shared"; // ένα φάκελο που μπορεί να προσεγγίσει κάθε κόμβος
d.SigningKey = farmKey; // τουλάχιστον 32 byte, το SAME σε κάθε κόμβο
}));Το σημείο ανοίγματος στη συνέχεια δεσμεύει το εισιτήριο στον περιηγητή πριν το άνοιγμα, και επιστρέφει το εισιτήριο μαζί με το token:
- ορίστε
DocOptions.BrowserId = DoconutFarmBinding.EnsureBrowserId(System.Web.HttpContext.Current, securityOptions)— εκδίδει το cookiedoconut-clientστο οποίο δεσμεύεται το εισιτήριο — καιDocOptions.UserId = DoconutFarmBinding.ResolveUserId(System.Web.HttpContext.Current); - μετά το
OpenDocumentAsync, επιστρέψτεviewer.AccessTokenμαζί με το token; - στη σελίδα, περάστε και τα δύο στο widget:
objViewer.View(token, access).
Μετάβαση από τη κλασική σημαία farm (IsWebfarm με ExportToPng); Η Μεταφορά δείχνει την αλλαγή βήμα προς βήμα.
Κρατήστε το κλειδί υπογραφής εκτός ελέγχου πηγαίου κώδικα: υπογράφει τα εισιτήρια και κρυπτογραφεί τα έγγραφα στο κοινόχρηστο αποθηκευτικό χώρο. Ένας κόμβος με διαφορετικό κλειδί απορρίπτει κάθε εισιτήριο που έχουν εκδώσει οι άλλοι.
Δοκιμάστε ένα farm με πραγματικό περιηγητή, ή ένα script που διατηρεί cookies. Ένας πελάτης χωρίς το cookie doconut-client δεν λαμβάνει απάντηση με 401: λαμβάνει την εικόνα σφάλματος «μη εξουσιοδοτημένο» με κατάσταση 200, περίπου 2 KB, ενώ μια πραγματική σελίδα είναι δεκάδες έως εκατοντάδες kilobytes.
Λίστα ελέγχου παραγωγής
- Διατηρήστε το
UnsafeMode = false(η προεπιλογή). - Ανοίξτε έγγραφα από αιτήματα που διαθέτουν κατάσταση συνεδρίας, και μην απενεργοποιείτε ποτέ την κατάσταση συνεδρίας.
- Βεβαιωθείτε ότι το cookie της συνεδρίας φθάνει στο
DocImage.axd(ίδια προέλευση, HTTPS, μια πολιτικήSameSiteπου το επιτρέπει). - Σε ένα farm, χρησιμοποιήστε κατανεμημένη λειτουργία με ένα κλειδί υπογραφής κοινόχρηστο από κάθε κόμβο.
- Καλέστε το
CloseDocumentόταν ο χρήστης αφήνει ένα έγγραφο — ωφελούνται τόσο η μνήμη όσο και η ασφάλεια. - Ποτέ μην καταγράφετε ή μοιράζεστε tokens· αντιμετωπίζετε τα ως βραχύβια διαπιστευτήρια.
Ήταν αυτή η σελίδα χρήσιμη;