Το όνομα αρχείου που ανέβηκε από τον πελάτη δεν μπορεί να χρησιμοποιηθεί απευθείας ως διαδρομή αποθήκευσης: για αποφυγή διέλευσης διαδρομής και διπλότυπη κάλυψη ονόματος
Το μεταφορτωμένο αρχείο ονομάζεται `../../report.pdf`, πράγμα που δεν σημαίνει ότι ο διακομιστής πρέπει να το αποθηκεύσει με αυτό το όνομα. Το όνομα του αρχείου προέρχεται από τον χρήστη και ανήκει στα δεδομένα εισόδου. η διαδρομή του δίσκου ανήκει στο όριο άδειας συστήματος. Η σύγχυση των δύο μπορεί εύκολα να οδηγήσει σε προβλήματα όπως η διέλευση διαδρομής, η διπλή κάλυψη ονομάτων και διαφορετικές συμπεριφορές μεταξύ Windows και Linux.
Ακριβώς επειδή το μεταφορτωμένο αρχείο ονομάζεται ../../report.pdf δεν σημαίνει ότι ο διακομιστής πρέπει να το αποθηκεύσει με αυτό το όνομα. Οι προγραμματιστές που γράφουν λειτουργίες μεταφόρτωσης από την πλευρά του διακομιστή, καθώς και οι ομάδες που πρέπει να ασχοληθούν με αρχεία χρήστη και ανησυχούν για τη διέλευση διαδρομής και την κάλυψη διπλών ονομάτων, θα αντιμετωπίσουν αυτό το πρόβλημα. Αφού διαβάσετε αυτό το άρθρο, θα μπορείτε να διακρίνετε μεταξύ εμφανιζόμενων ονομάτων και ονομάτων αποθήκευσης, να γνωρίζετε τι ελέγχους πρέπει να γίνονται σε κάθε επίπεδο και να εξετάζετε τη δική σας υλοποίηση σύμφωνα με τα στοιχεία αποδοχής.
Το όνομα του αρχείου προέρχεται από τον χρήστη και ανήκει στα δεδομένα εισόδου. η διαδρομή του δίσκου ανήκει στο όριο άδειας συστήματος. Η σύγχυση των δύο μπορεί εύκολα να οδηγήσει σε προβλήματα όπως η διέλευση διαδρομής, η διπλή κάλυψη ονομάτων και διαφορετικές συμπεριφορές μεταξύ Windows και Linux.
Αυτό το άρθρο χρησιμοποιεί συνθετικά δείγματα για να δείξει τη μέθοδο επεξεργασίας. Ο κώδικας έχει ελεγχθεί δειγματοληπτικά σε απομονωμένο περιβάλλον και δεν αποτελεί εγγύηση για όλα τα πραγματικά αρχεία ή την απόδοση του προϊόντος. Πριν επεξεργαστείτε σημαντικά έγγραφα, διατηρήστε τα πρωτότυπα και ελέγξτε τα σύμφωνα με τα όρια και τα στοιχεία αποδοχής στο κείμενο.
Μπορεί το όνομα του μεταφορτωμένου αρχείου να χρησιμοποιηθεί απευθείας ως διαδρομή αποθήκευσης; Μια φράση συμπέρασμα
Δεν μπορεί να χρησιμοποιηθεί απευθείας. Το εμφανιζόμενο όνομα χρησιμοποιείται για την εμφάνιση της διεπαφής και η διαδρομή αποθήκευσης δημιουργείται από τον διακομιστή με βάση το εσωτερικό αναγνωριστικό.
| την κατάστασή σας | Συνιστώμενες πρακτικές | λόγος |
|---|---|---|
| Το αρχικό όνομα αρχείου του χρήστη πρέπει να εμφανίζεται στη διεπαφή | Εμφανιζόμενο όνομα έχει δεσμευτεί μόνο για προβολή | Το εμφανιζόμενο όνομα διαχωρίστηκε από τη διαδρομή δίσκου για να αποφευχθεί η διέλευση διαδρομής |
| Πρέπει να αποθηκεύσετε τα μεταφορτωμένα αρχεία | Ο διακομιστής δημιουργεί ένα εσωτερικό αναγνωριστικό και ενώνει τη διαδρομή αποθήκευσης | Αποφύγετε την αντικατάσταση με διπλά ονόματα και μην επηρεάζεστε από την εισαγωγή του χρήστη |
| Η επέκταση αρχείου πρέπει να συμμετέχει στον χώρο αποθήκευσης | Πάρτε επίθημα από τη λίστα επιτρεπόμενων διακομιστή | Μην αντιγράφετε επεκτάσεις που δίνονται από χρήστες |
| Πρέπει να προσδιοριστεί ο πραγματικός τύπος του αρχείου | Κάντε ανίχνευση και ανάλυση περιεχομένου | Οι επεκτάσεις μπορούν να παραποιηθούν |
Το εμφανιζόμενο όνομα και το όνομα αποθήκευσης διαχωρίζονται
Το αρχικό όνομα διατηρείται για την εμφάνιση της διεπαφής, αλλά η εσωτερική αναγνώριση δημιουργείται από τον διακομιστή. Το επίθημα αποθήκευσης θα πρέπει επίσης να προέρχεται από την επιτρεπόμενη λίστα από την πλευρά του διακομιστή, αντί να αντιγράφει την επέκταση που δίνεται από τον χρήστη.
Το παρακάτω παράδειγμα δημιουργεί μόνο μια διαδρομή και δεν δημιουργεί κατάλογο ή αρχείο.
Κατασκευαστής ελάχιστης διαδρομής
from pathlib import Path
import re
def storage_path(root, internal_id, extension):
if not re.fullmatch(r"[a-f0-9]{32}", internal_id):
raise ValueError("invalid internal id")
if extension not in {".pdf", ".docx", ".udoc"}:
raise ValueError("unsupported extension")
base = Path(root).resolve()
candidate = (base / (internal_id + extension)).resolve()
if candidate.parent != base:
raise ValueError("outside storage root")
return candidate
root = Path.cwd() / "synthetic-uploads"
identifier = "a" * 32
p = storage_path(root, identifier, ".pdf")
assert p.parent == root.resolve()
assert p.name == identifier + ".pdf"
for bad in ["../../report", "A" * 32, "a" * 31, "a" * 32 + "/x"]:
try:
storage_path(root, bad, ".pdf")
except ValueError:
pass
else:
raise AssertionError(bad)
Αυτό το παράδειγμα προϋποθέτει ότι το εσωτερικό αναγνωριστικό έχει δημιουργηθεί από τον διακομιστή. Δεν είναι μια ασφαλής υλοποίηση αρχείου εγγραφής για αυθαίρετα περιβάλλοντα επίθεσης δίσκου:
- Μπορεί να συνεχιστεί ένας αγώνας μεταξύ του ελέγχου και του πραγματικού ανοίγματος.
- Τα δικαιώματα γονικού καταλόγου και οι πολιτικές συμβολικών συνδέσμων πρέπει να ελέγχονται χωριστά.
- Ένα μοναδικό αναγνωριστικό δεν σημαίνει επίσης ότι η πολιτική "χωρίς παράκαμψη" μπορεί να αγνοηθεί.
Η απολύμανση ονόματος αρχείου δεν είναι έλεγχος ταυτότητας αρχείου
Ο καθαρισμός ονόματος αρχείου μπορεί να λύσει μόνο μέρος του προβλήματος και διαφορετικά φαινόμενα πρέπει να αντιμετωπίζονται σε διαφορετικά επίπεδα:
| φαινόμενο εισόδου | Σε ποιο επίπεδο πρέπει να υποβληθεί σε επεξεργασία; | ελλείψεις |
|---|---|---|
| Περιέχει διαχωριστικό διαδρομής | Δεν χρησιμοποιείται ως διαδρομή αποθήκευσης | Η απλή αφαίρεση της διαγώνιας γραμμής δεν αρκεί |
| Επέκταση PDF | Ανίχνευση και ανάλυση περιεχομένου | Οι επεκτάσεις μπορούν να πλαστογραφηθούν |
| Εμφανιζόμενο όνομα που περιέχει HTML | Διαφυγή εξόδου διεπαφής | Δεν μπορεί να λυθεί με μετονομασία του δίσκου |
| Ίδιο εμφανιζόμενο όνομα | Εσωτερική απομόνωση ταυτότητας | Δεν πρέπει να παρακάμπτει την προηγούμενη μεταφόρτωση |
📊 Σύγκριση πυρήνων
| Μέθοδος | Τι μπορεί να λυθεί; | και οι αδυναμίες |
|---|---|---|
| Χρησιμοποιήστε απευθείας το όνομα αρχείου χρήστη | Η απλούστερη υλοποίηση | Ενδέχεται να συμβεί διάσχιση διαδρομής και παρακάμψεις διπλότυπων ονομάτων |
| Αφαιρέστε μόνο τον διαχωριστή διαδρομής | Επεξεργασμένο μέρος της εισόδου | Η απλή αφαίρεση της διαγώνιας γραμμής δεν αρκεί |
| Καθορίστε τον τύπο βάσει της επέκτασης | Προκαταρκτική διαφοροποίηση εγγράφων | Οι επεκτάσεις μπορούν να πλαστογραφηθούν και πρέπει να χρησιμοποιούνται για ανίχνευση περιεχομένου |
| Ο διακομιστής δημιουργεί το εσωτερικό αναγνωριστικό | Απομονώστε διπλότυπα αρχεία και οι διαδρομές ελέγχονται από το σύστημα | Εξακολουθεί να απαιτεί συνεργασία με την πολιτική "Χωρίς παράκαμψη" και τον έλεγχο δικαιωμάτων καταλόγου |
Η αποθήκευση αντικειμένων έχει τα ίδια όρια
Τα R2 ή άλλα object stores δεν έχουν την πλήρη σημασιολογία της παραδοσιακής περιήγησης σε καταλόγους, αλλά τα κλειδιά αντικειμένων εξακολουθούν να επηρεάζουν την απομόνωση, την παράκαμψη και την έκθεση των URLs.
- Μην γράφετε τις συμβολοσειρές που παρέχονται από τον ενοικιαστή απευθείας σε κοινόχρηστα προθέματα.
- Ο downloader δεν μπορεί να συμπεράνει εξουσιοδότηση μόνο από ονόματα κλειδιών.
Τα έγγραφα πρέπει να έχουν ταυτότητα πριν από τη μετάφρασή τους
Κατά την πρόσβαση στη ροή εργασίας OmniDoc (Πύλη Προϊόντων), οι χρήστες μπορούν να συνεχίσουν να βλέπουν γνωστά ονόματα αρχείων, χρησιμοποιώντας εσωτερικά ανεξάρτητα αναγνωριστικά εργασιών και αναγνωριστικά αρχείων.
Η σαφής ταυτότητα εγγράφου φέρνει τα εξής οφέλη:
- Όταν η επανάληψη αποτυγχάνει, μπορεί να αντιστοιχεί με ακρίβεια στην αρχική εργασία.
- Λήψη και επακόλουθη διόρθωση της μετάφρασης για να διασφαλιστεί ότι ταιριάζει με τα σωστά αρχεία.
- Μειώστε τον κίνδυνο να αντιμετωπιστεί το αρχείο κάποιου άλλου με το ίδιο όνομα όπως το τρέχον αποτέλεσμα.
🎯 Ποια προσέγγιση σου ταιριάζει;
Εάν πρέπει να εμφανίσετε το όνομα του αρχείου
Το αρχικό εμφανιζόμενο όνομα του χρήστη διατηρείται, αλλά μόνο για τη διεπαφή και όχι για τη διαδρομή του δίσκου.
Αν χρειαστεί να αποθηκεύσετε το αρχείο μεταφόρτωσης
Ο διακομιστής δημιουργεί εσωτερικά αναγνωριστικά, παίρνει καταλήξεις από τη λίστα επιτρεπόμενων και ελέγχει τα δικαιώματα παράκαμψης και καταλόγου σύμφωνα με τις πραγματικές πολιτικές.
Αν χρησιμοποιείτε αποθήκευση αντικειμένων
Μην γράφετε τις συμβολοσειρές ενοικιαστή απευθείας στο πρόθεμα κοινής χρήσης· κατά τη λήψη, κάντε ξεχωριστούς ελέγχους εξουσιοδότησης.
❓ Συχνές Ερωτήσεις (FAQ)
1. Εάν αφαιρέσετε τις διαγώνιες γραμμές, το όνομα αρχείου γίνεται ασφαλές;
Δεν είναι αρκετό. Η αφαίρεση μόνο των καθέτων επεξεργάζεται μόνο ένα μέρος της εισόδου. Η κατασκευή διαδρομής, η παράκαμψη και ο προσδιορισμός του τύπου αρχείου πρέπει να αντιμετωπίζονται ξεχωριστά.
2. Μόνο και μόνο επειδή η επέκταση είναι PDF, μπορεί να επιβεβαιωθεί ως PDF;
Όχι. Οι επεκτάσεις μπορούν να πλαστογραφηθούν, απαιτώντας ανίχνευση και ανάλυση περιεχομένου.
3. Τι να κάνετε αν το εμφανιζόμενο όνομα περιέχει HTML;
Η διαφυγή κατά την έξοδο διεπαφής δεν μπορεί να λυθεί αλλάζοντας το όνομα αρχείου στον δίσκο.
4. Πρέπει ακόμα να απενεργοποιήσω τις παρακάμψεις μετά τη χρήση μοναδικού ID;
Ναι. Ένα μοναδικό αναγνωριστικό δεν σημαίνει ότι η πολιτική «Χωρίς Παράκαμψη» μπορεί να αγνοηθεί.
📝 Περίληψη
Τα ονόματα αρχείων μεταφόρτωσης πρέπει να χειρίζονται ξεχωριστά από τη διαδρομή αποθήκευσης: χρησιμοποιούνται εμφανιζόμενα ονόματα για την εμφάνιση και οι διαδρομές αποθήκευσης δημιουργούνται από τον διακομιστή βάσει εσωτερικών αναγνωριστικών. Η διαδρομή, η παράκαμψη, ο τύπος και η εξουσιοδότηση πρέπει να επαληθεύονται ξεχωριστά.
Αναφορές: Python pathlib


