Der vom Kunden hochgeladene Dateiname kann nicht direkt als Speicherpfad verwendet werden: um Pfaddurchquerung und doppelte Namensabdeckung zu verhindern
Die hochgeladene Datei heißt `../../report.pdf`, was nicht bedeutet, dass der Server sie unter diesem Namen speichern soll. Der Dateiname stammt vom Benutzer und gehört zu den Eingabedaten; Der Festplattenpfad gehört zur Systemberechtigungsgrenze. Eine Verwechslung der beiden kann leicht zu Problemen wie Pfaddurchquerung, doppelter Namensabdeckung und unterschiedlichem Verhalten zwischen Windows und Linux führen.
Nur weil die hochgeladene Datei den Namen ../../report.pdf trägt, heißt das nicht, dass der Server sie unter diesem Namen speichern sollte. Entwickler, die serverseitige Upload-Funktionen schreiben, sowie Teams, die sich mit Benutzerdateien befassen und sich um Pfaddurchquerung und doppelte Namensabdeckung kümmern müssen, werden auf dieses Problem stoßen. Nachdem Sie diesen Artikel gelesen haben, können Sie zwischen Anzeigenamen und Speichernamen unterscheiden, wissen, welche Prüfungen auf jeder Ebene durchgeführt werden sollten, und Ihre eigene Implementierung anhand der Akzeptanzpunkte überprüfen.
Der Dateiname stammt vom Benutzer und gehört zu den Eingabedaten; Der Festplattenpfad gehört zur Systemberechtigungsgrenze. Eine Verwechslung der beiden kann leicht zu Problemen wie Pfaddurchquerung, doppelter Namensabdeckung und unterschiedlichem Verhalten zwischen Windows und Linux führen.
In diesem Artikel werden synthetische Proben verwendet, um die Verarbeitungsmethode zu demonstrieren. Der Code wurde in einer isolierten Umgebung stichprobenartig überprüft und stellt keine Garantie für alle echten Dateien oder die Produktleistung dar. Bevor Sie wichtige Dokumente bearbeiten, bewahren Sie bitte die Originale auf und überprüfen Sie sie anhand der Grenzen und Akzeptanzpunkte im Text.
Kann der hochgeladene Dateiname direkt als Speicherpfad verwendet werden? Fazit in einem Satz
Es kann nicht direkt verwendet werden. Der Anzeigename wird für die Schnittstellenanzeige verwendet und der Speicherpfad wird vom Server basierend auf der internen ID generiert.
| Ihre Situation | Empfohlene Praktiken | Grund |
|---|---|---|
| Der ursprüngliche Dateiname des Benutzers muss auf der Benutzeroberfläche angezeigt werden | Anzeigename nur zur Anzeige reserviert | Anzeigename vom Festplattenpfad getrennt, um Pfadkreuzungen zu vermeiden |
| Hochgeladene Dateien müssen gespeichert werden | Der Server generiert eine interne ID und verbindet den Speicherpfad | Vermeiden Sie das Überschreiben mit doppelten Namen und lassen Sie sich nicht durch Benutzereingaben beeinträchtigen |
| Die Dateierweiterung muss an der Speicherung teilnehmen | Übernehmen Sie das Suffix aus der Liste der zulässigen Server | Kopieren Sie keine von Benutzern bereitgestellten Erweiterungen |
| Der wahre Typ der Datei muss ermittelt werden | Führen Sie eine Inhaltserkennung und -analyse durch | Erweiterungen können gefälscht sein |
Anzeigename und Speichername sind getrennt
Der ursprüngliche Name bleibt für die Schnittstellenanzeige erhalten, die interne Identifikation wird jedoch vom Server generiert. Das Speichersuffix sollte ebenfalls aus der serverseitigen Zulassungsliste stammen und nicht die vom Benutzer angegebene Erweiterung kopieren.
Das folgende Beispiel erstellt nur einen Pfad und erstellt kein Verzeichnis oder keine Datei.
Minimaler Pfadkonstruktor
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)
In diesem Beispiel wird davon ausgegangen, dass die interne ID vom Server generiert wurde. Es handelt sich nicht um eine sichere Schreibdateiimplementierung für Umgebungen mit beliebigen Festplattenangriffen:
- Es kann immer noch zu einem Wettlauf zwischen Kontrolle und tatsächlicher Öffnung kommen.
- Berechtigungen für übergeordnete Verzeichnisse und Richtlinien für symbolische Links müssen separat gesteuert werden.
– Eine eindeutige ID bedeutet auch nicht, dass die „No Override"-Richtlinie ignoriert werden kann.
Dateinamensreinigung ist keine Dateiauthentifizierung
Die Dateinamen-Bereinigung kann nur einen Teil des Problems lösen; verschiedene Phänomene müssen auf verschiedenen Ebenen behandelt werden:
| Eingabephänomen | Auf welcher Ebene sollte es behandelt werden? | Schwächen |
|---|---|---|
| Enthält Wegtrenner | Nicht als Speicherpfad verwendet | Nur das Entfernen der diagonalen Linie reicht nicht aus |
| Die Dateiendung ist PDF | Inhaltserkennung und -analyse | Erweiterungen können gefälscht werden |
| Anzeigename, der HTML enthält | Interface-Ausgang entweicht | Du kannst es nicht lösen, indem du den Namen der Festplatte änderst |
| Gleicher Anzeigename | Interne ID-Isolierung | Es sollte den vorherigen Upload nicht überschreiben |
📊 Kernvergleich
| Methode | Was kann gelöst werden? | Schwächen |
|---|---|---|
| Verwenden Sie direkt den Dateinamen des Benutzers | Die Implementierung ist am einfachsten | Pfaddurchquerung und Überschreiben von doppelten Namen können auftreten |
| Entfernen Sie nur den Wegtrenner | Einen Teil der Eingabe verarbeitet | Nur das Entfernen der diagonalen Linie reicht nicht aus |
| Bestimmen Sie den Typ anhand der Verlängerung | Vorläufige Unterscheidung der Dokumente | Erweiterungen können gefälscht werden und müssen mit der Inhaltserkennung koordiniert werden |
| Der Server generiert interne IDs | Isoliere doppelte Dateien, deren Pfade vom System gesteuert werden | Es erfordert weiterhin die Zusammenarbeit mit der "No Override"-Richtlinie und der Verzeichnisberechtigungskontrolle |
Objektspeicherung hat dieselben Grenzen
R2 oder andere Objekte speichern alle Semantiken ohne traditionelle Verzeichnisdurchlauf, aber Objektschlüssel beeinflussen weiterhin die Isolation, das Überschreiben und die Offenlegung von URLs.
- Buchstabieren Sie den vom tenant bereitgestellten String nicht direkt in ein gemeinsames Präfix.
- Der Downloader kann die Autorisierung nicht ausschließlich anhand von Schlüsselnamen ableiten.
Dokumente sollten eine Identität haben, bevor sie in die Übersetzung aufgenommen werden
Beim Zugriff auf den OmniDoc (Produkteinführung)-Workflow können Benutzer weiterhin vertraute Dateinamen sehen, intern mit unabhängigen Task-IDs und Datei-IDs.
Eindeutige Dokumentidentitäten bringen folgende Vorteile mit sich:
- Beim Scheitern und erneuten Versuchen kann es der ursprünglichen Aufgabe genau entsprechen.
- Übersetzung, Download und anschließendes Korrekturlesen stellen sicher, dass die korrekte Datei abgestimmt wird.
- Verringert das Risiko, dass die Datei eines anderen mit demselben Namen wie das aktuelle Ergebnis verwechselt wird.
🎯 Welche Methode passt zu dir?
Wenn du den Dateinamen anzeigen musst
Der ursprüngliche Anzeigename des Benutzers wird beibehalten, jedoch nur für die Schnittstelle, nicht für den Festplattenpfad.
Wenn du Dateien speichern und hochladen musst
Der Server erzeugt die interne ID, nimmt die Erweiterung aus der Zulassungsliste und steuert die Abdeckung sowie Verzeichnisberechtigungen gemäß den tatsächlichen Richtlinien.
Wenn du Objektspeicher verwendest
Buchstabieren Sie Tenant-Strings nicht direkt mit dem Präfix 'share' und treffen Sie beim Herunterladen separate Autorisierungsentscheidungen.
❓ Häufig gestellte Fragen (FAQ)
1. Wenn du die diagonalen Linien entfernst, wird der Dateiname dann sicher?
Nicht genug. Das Entfernen nur der Schrägstrichstriche verarbeitet nur einen Teil der Eingabe; Pfadbau, Übersteuerung und Dateitypbestimmung müssen weiterhin getrennt behandelt werden.
2. Wenn die Dateiendung PDF ist, kann man sie dann als PDF bestätigen?
Nein. Erweiterungen können gefälscht werden, die Inhaltserkennung und -parsing erfordern.
3. Was soll ich tun, wenn der Anzeigename HTML enthält?
Escape während der Schnittstellenausgabe kann nicht durch Änderung des Dateinamens auf der Festplatte gelöst werden.
4. Muss ich nach der Verwendung einer eindeutigen ID das Überschreiben trotzdem deaktivieren?
Ja. Eine eindeutige ID bedeutet nicht, dass Sie die "Keine Überschreibung"-Regelung ignorieren können.
📝 Zusammenfassung
Der Dateiname des Uploads sollte getrennt vom Speicherpfad behandelt werden: Der Anzeigename wird für die Anzeige verwendet, und der Speicherpfad wird vom Server basierend auf der internen ID generiert. Wege, Abdeckungen, Arten und Genehmigungen müssen separat überprüft werden.
Quellen: Python pathlib


