Az ügyfél által feltöltött fájlnév nem használható közvetlenül tárolási útvonalként: az útvonal bejárásának és a duplikált névlefedettség megakadályozására
A feltöltött fájl neve `../../report.pdf`, ami nem jelenti azt, hogy a szervernek ezen a néven kell mentenie. A fájlnév a felhasználótól származik, és a bemeneti adatokhoz tartozik; a lemez elérési útja a rendszerengedély-határhoz tartozik. A kettő összekeverése könnyen olyan problémákhoz vezethet, mint az útvonal bejárása, a névlefedettség duplikáltsága, valamint a Windows és a Linux közötti eltérő viselkedés.
Az, hogy a feltöltött fájl neve ../../report.pdf, nem jelenti azt, hogy a szervernek ezen a néven kell mentenie. A szerveroldali feltöltési funkciókat író fejlesztők, valamint a felhasználói fájlokkal foglalkozó csapatok, akiknek aggódniuk kell az útvonal bejárása és a duplikált névlefedettség miatt, szembesülnek ezzel a problémával. A cikk elolvasása után képes lesz megkülönböztetni a megjelenített neveket és a tárhelyneveket, tudni fogja, milyen ellenőrzéseket kell elvégezni az egyes rétegeknél, és áttekintheti saját megvalósítását az elfogadási tételek szerint.
A fájlnév a felhasználótól származik, és a bemeneti adatokhoz tartozik; a lemez elérési útja a rendszerengedély-határhoz tartozik. A kettő összekeverése könnyen olyan problémákhoz vezethet, mint az útvonal bejárása, a névlefedettség duplikáltsága, valamint a Windows és a Linux közötti eltérő viselkedés.
Ez a cikk szintetikus mintákat használ a feldolgozási módszer bemutatására. A kód mintaellenőrzésen esett át elszigetelt környezetben, és nem garantálja az összes valós fájlt vagy a termék teljesítményét. A fontos dokumentumok feldolgozása előtt kérjük, őrizze meg az eredeti példányokat és nézze át a szövegben szereplő határok és átvételi tételek szerint.
A feltöltött fájlnév közvetlenül használható tárolási útvonalként? Egy mondatos következtetés
Közvetlenül nem használható. A megjelenített név az interfész megjelenítésére szolgál, a tárolási útvonalat pedig a szerver hozza létre a belső azonosító alapján.
| a helyzeted | Ajánlott gyakorlatok | ok |
|---|---|---|
| A felhasználó eredeti fájlnevét meg kell jeleníteni a felületen | A megjelenített név csak megjelenítésre van fenntartva | A megjelenített név elválasztva a lemez elérési útjától az útvonal keresztezésének elkerülése érdekében |
| A feltöltött fájlokat menteni kell | A szerver létrehoz egy belső azonosítót, és összekapcsolja a tárolási útvonalat | Kerülje a duplikált nevekkel történő felülírást, és ne befolyásolja a felhasználói bevitel |
| A fájlkiterjesztésnek részt kell vennie a tárolásban | Vegye ki az utótagot a szerver engedélyezett listájából | Ne másolja le a felhasználók által megadott kiterjesztéseket |
| Meg kell határozni a fájl valódi típusát | Végezzen tartalomfelismerést és elemzést | A bővítmények hamisíthatók |
A megjelenített név és a tárhely neve el van választva
Az eredeti név megmarad az interfész megjelenítésénél, de a belső azonosítást a szerver generálja. A tárolási utótagnak is a szerveroldali engedélyezett listából kell származnia, nem pedig a felhasználó által megadott kiterjesztést másolni.
A következő példa csak elérési utat hoz létre, könyvtárat vagy fájlt nem hoz létre.
Minimális útvonal-konstruktor
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)
Ez a példa feltételezi, hogy a belső azonosítót a szerver hozta létre. Ez nem egy biztonságos írási fájl megvalósítás tetszőleges lemeztámadási környezetekhez:
- Verseny még előfordulhat az ellenőrzés és a tényleges nyitás között.
- A szülőkönyvtár-engedélyeket és a szimbolikus hivatkozási házirendeket külön kell szabályozni.
- Az egyedi azonosító nem jelenti azt sem, hogy figyelmen kívül hagyható a „nem felülbírálás"szabály.
A fájlnév-megtisztítás nem fájlhitelesítés
A fájlnév-tisztítás csak a probléma egy részét tudja megoldani, és a különböző jelenségeket különböző szinteken kell kezelni:
| bemeneti jelenség | Milyen szinten kell feldolgozni? | hiányosságait |
|---|---|---|
| Útleválasztót tartalmaz | Tárolási útvonalként nem használják | A perjel egyszerű eltávolítása nem elég |
| kiterjesztés PDF | Tartalomfelismerés és elemzés | A bővítmények hamisíthatók |
| A megjelenített név HTML-t tartalmaz | Az interfész kimenet kilép | A lemeznév megváltoztatásával nem lehet megoldani. |
| Ugyanaz a megjelenített név | Belső azonosító szigetelés | A korábbi feltöltést nem szabad felülírni |
📊 Alapvető összehasonlítás
| gyakorlat | Mit lehet megoldani | hiányosságait |
|---|---|---|
| Használja közvetlenül a felhasználói fájl nevét | A legegyszerűbb megvalósítás | Előfordulhat útkereszteződés és duplikált névlefedettség |
| Csak távolítsa el az útelválasztókat | A bemenet feldolgozott része | A perjel egyszerű eltávolítása nem elég |
| A típus meghatározása kiterjesztés alapján | előzetes megkülönböztetési fájl | A bővítmények hamisíthatók, és tartalomészlelés szükséges. |
| Szerveroldali generált belső azonosító | Az azonos nevű fájlokat izolálja, az elérési utat a rendszer vezérli | Továbbra is együtt kell működnie a „nem felülírható"házirenddel és a címtárengedély-vezérléssel |
Az objektumtárolásnak is ugyanazok a határai
Az R2 vagy más objektumtárolók nem rendelkeznek a hagyományos címtárbejárás teljes szemantikájával, de az objektumkulcsok továbbra is hatással vannak az elkülönítésre, a felülírásokra és a szabadon elérhető URL-ekre.
- Ne írja be közvetlenül a bérlő által megadott karakterláncot megosztott előtagba.
- A letöltő csak a kulcsnév alapján nem tud jogosultságra következtetni.
A fájlnak azonosítóval kell rendelkeznie a fordítás bevitele előtt
Amikor csatlakozik a OmniDoc (termékportál) munkafolyamathoz, továbbra is ismerős fájlneveket jeleníthet meg a felhasználók számára, és belsőleg használhat független feladat- és fájlazonosítókat.
A tiszta dokumentumazonosság a következő előnyökkel jár:
- Ha az újrapróbálkozás sikertelen, pontosan megfelelhet az eredeti feladatnak.
- A fordítási kézirat letöltése és az azt követő felülvizsgálat megfelelhet a megfelelő fájlnak.
- Csökkentse annak kockázatát, hogy valaki más fájlját az aktuális eredménnyel azonos néven kezelje.
🎯 Melyik módszer illik hozzád?
Ha meg kell jelenítenie a fájl nevét
A felhasználó eredeti megjelenített neve megmarad, de csak az interfészhez használható, a lemez elérési útjához nem.
Ha el kell mentenie a feltöltött fájlt
A belső azonosítót a szerver állítja elő, az utótagot az engedélyezett listából veszi, és a lefedettséget és a címtárengedélyeket a tényleges házirendnek megfelelően szabályozza.
Ha objektumtárolást használ
Ne írja be közvetlenül a bérlői karakterláncot egy megosztott előtagba, és a letöltés során hozzon külön engedélyezési döntéseket.
❓ Gyakran Ismételt Kérdések (GYIK)
1. Ha eltávolítja a perjelet, biztonságos lesz a fájlnév?
nem elég. Csak a perjelek eltávolítása csak a bemenet egy részét tudja feldolgozni, és az elérési út-építést, a felülírást és a fájltípus meghatározását továbbra is külön kell feldolgozni.
2. Csak azért, mert a kiterjesztés PDF, az azt jelenti, hogy PDF?
nem lehet. A bővítmények hamisíthatók, és tartalomfelismerést és elemzést igényelnek.
3. Mi a teendő, ha a megjelenített név HTML-t tartalmaz?
Escape interfész kimenet közben nem oldható meg a lemezen lévő fájlnév módosításával.
4. Egyedi azonosító használata után továbbra is le kell tiltanom a felülírást?
igény. Az egyedi azonosító nem jelenti azt, hogy a „nincs felülbírálás"irányelv figyelmen kívül hagyható.
📝 Összefoglaló
A feltöltött fájl nevét a tárolási útvonaltól elkülönítve kell kezelni: a megjelenített név a megjelenítésre szolgál, a tárolási útvonalat pedig a szerver generálja a belső azonosító alapján. Az elérési út, a lefedettség, a típus és a jogosultság mindegyike függetlenül ellenőrzött.
Források: Python pathlib


